YugabyteDB

YugabyteDB Session management API

The Session management API from YugabyteDB — 9 operation(s) for session management.

Documentation GitHub OpenAPI

Operations 9

POST /api/v1/api_login Authenticate user using email and password #

GET /api/v1/app_version appVersion #

GET /api/v1/customer_count customerCount #

GET /api/v1/customers/{cUUID}/admin_notifications Current list of notifications for admin #

PUT /api/v1/customers/{cUUID}/api_token Regenerate and fetch API token #

GET /api/v1/logs getFilteredLogs #

GET /api/v1/logs/{maxLines} getLogs #

POST /api/v1/register Register a customer #

GET /api/v1/session_info Get current user and customer uuid. This will not generate or return the API token, use /api_token API for that. #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/yugabytedb-session-management-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Yugabytedb Session management API
  version: v1
  contact:
    name: https://docs.yugabyte.com
  license:
    name: Polyform Free Trial License 1.0.0
    url: https://github.com/yugabyte/yugabyte-db/blob/master/licenses/POLYFORM-FREE-TRIAL-LICENSE-1.0.0.txt
  termsOfService: TODO(chirag)
  x-refined-note:
  - x-source differs across the merged source definitions and was not carried
  - x-split-from differs across the merged source definitions and was not carried
  description: 'Operations tagged Session management across 4 of this provider''s published API definitions: openapi_2.yaml, platform.swagger.json, yugabytedb-anywhere-v1-full.yaml, yugabytedb-anywhere-v1-users-rbac.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: /
tags:
- name: Session management
paths:
  /api/v1/api_login:
    post:
      operationId: apiLogin
      parameters:
      - in: query
        name: request
        schema: {}
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CustomerLoginFormData'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionInfo'
          description: successful operation
      summary: Authenticate user using email and password
      tags:
      - Session management
      x-codegen-request-body-name: CustomerLoginFormData
    servers:
    - url: /
  /api/v1/app_version:
    get:
      operationId: appVersion
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties:
                  type: string
                type: object
          description: successful operation
      summary: appVersion
      tags:
      - Session management
    servers:
    - url: /
  /api/v1/customer_count:
    get:
      operationId: customerCount
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerCountResp'
          description: successful operation
      summary: customerCount
      tags:
      - Session management
    servers:
    - url: /
  /api/v1/customers/{cUUID}/admin_notifications:
    get:
      description: 'WARNING: This is a preview API that could change.'
      operationId: getAdminNotifications
      parameters:
      - in: path
        name: cUUID
        required: true
        schema:
          format: uuid
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Current_admin_notification_messages'
          description: successful operation
      summary: Current list of notifications for admin
      tags:
      - Session management
    servers:
    - url: /
  /api/v1/customers/{cUUID}/api_token:
    put:
      operationId: api_token
      parameters:
      - in: path
        name: cUUID
        required: true
        schema:
          format: uuid
          type: string
      - in: query
        name: apiTokenVersion
        schema:
          default: -1
          format: int64
          type: integer
      - in: query
        name: request
        schema: {}
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionInfo'
          description: successful operation
      summary: Regenerate and fetch API token
      tags:
      - Session management
    servers:
    - url: /
  /api/v1/logs:
    get:
      operationId: getFilteredLogs
      parameters:
      - in: query
        name: maxLines
        schema:
          default: 10000
          format: int32
          type: integer
      - in: query
        name: universeName
        schema:
          default: 'null'
          type: string
      - in: query
        name: queryRegex
        schema:
          default: 'null'
          type: string
      - in: query
        name: startDate
        schema:
          default: 'null'
          type: string
      - in: query
        name: endDate
        schema:
          default: 'null'
          type: string
      responses:
        '200':
          content:
            text/plain:
              schema:
                type: string
          description: successful operation
      summary: getFilteredLogs
      tags:
      - Session management
    servers:
    - url: /
  /api/v1/logs/{maxLines}:
    get:
      operationId: getLogs
      parameters:
      - in: path
        name: maxLines
        required: true
        schema:
          format: int32
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LogData'
          description: successful operation
      summary: getLogs
      tags:
      - Session management
    servers:
    - url: /
  /api/v1/register:
    post:
      description: Creates new customer and user
      operationId: registerCustomer
      parameters:
      - in: query
        name: generateApiToken
        schema:
          default: false
          type: boolean
      - in: query
        name: request
        schema: {}
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CustomerRegisterFormData'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionInfo'
          description: successful operation
      summary: Register a customer
      tags:
      - Session management
      x-codegen-request-body-name: CustomerRegisterFormData
    servers:
    - url: /
  /api/v1/session_info:
    get:
      description: Available since YBA version 2.20.0.
      operationId: getSessionInfo
      parameters:
      - in: query
        name: request
        schema: {}
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionInfo'
          description: successful operation
      security:
      - apiKeyAuth: []
      summary: Get current user and customer uuid. This will not generate or return the API token, use /api_token API for that.
      tags:
      - Session management
    servers:
    - url: /
components:
  schemas:
    Admin_notification:
      example:
        code: code
        htmlMessage: htmlMessage
      properties:
        code:
          description: Notification code
          readOnly: true
          type: string
        htmlMessage:
          description: Notification message with HTML markup
          readOnly: true
          type: string
      type: object
    CustomerLoginFormData:
      example:
        password: password
        email: email
      properties:
        email:
          type: string
        password:
          type: string
      required:
      - email
      - password
      type: object
    LogData:
      example:
        lines:
        - lines
        - lines
      properties:
        lines:
          items:
            type: string
          type: array
      required:
      - lines
      type: object
    CustomerCountResp:
      example:
        count: 0
      properties:
        count:
          format: int32
          type: integer
      required:
      - count
      type: object
    Current_admin_notification_messages:
      example:
        messages:
        - code: code
          htmlMessage: htmlMessage
        - code: code
          htmlMessage: htmlMessage
      properties:
        messages:
          description: Messages
          items:
            $ref: '#/components/schemas/Admin_notification'
          readOnly: true
          type: array
      type: object
    SessionInfo:
      description: Session information
      example:
        apiToken: apiToken
        customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        apiTokenVersion: 0
        authToken: authToken
        userUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
      properties:
        apiToken:
          description: API token
          type: string
        apiTokenVersion:
          description: API token version
          format: int64
          type: integer
        authToken:
          description: Auth token
          type: string
        customerUUID:
          description: Customer UUID
          format: uuid
          type: string
        userUUID:
          description: User UUID
          format: uuid
          type: string
      type: object
    CustomerRegisterFormData:
      example:
        password: password
        code: code
        name: name
        email: email
      properties:
        code:
          type: string
        email:
          type: string
        name:
          type: string
        password:
          type: string
      required:
      - code
      - email
      - name
      - password
      type: object
    CustomerCountResp_2:
      properties:
        count:
          format: int32
          type: integer
      required:
      - count
      type: object
    SessionInfo_2:
      description: Session information
      properties:
        apiToken:
          description: API token
          type: string
        authToken:
          description: Auth token
          type: string
        customerUUID:
          description: Customer UUID
          format: uuid
          type: string
        userUUID:
          description: User UUID
          format: uuid
          type: string
      type: object
    CustomerRegisterFormData_2:
      properties:
        code:
          type: string
        email:
          type: string
        name:
          type: string
        password:
          type: string
      required:
      - code
      - email
      - name
      - password
      type: object
    LogData_2:
      properties:
        lines:
          items:
            type: string
          type: array
      required:
      - lines
      type: object
    Admin_notification_2:
      example:
        code: code
        htmlMessage: htmlMessage
      properties:
        code:
          description: Notification code
          readOnly: true
          type: string
          example: OK
        htmlMessage:
          description: Notification message with HTML markup
          readOnly: true
          type: string
          example: Example htmlMessage
      type: object
    CustomerLoginFormData_2:
      example:
        password: password
        email: email
      properties:
        email:
          type: string
          example: admin@example.com
        password:
          type: string
          example: REDACTED
      required:
      - email
      - password
      type: object
    LogData_3:
      example:
        lines:
        - lines
        - lines
      properties:
        lines:
          items:
            type: string
          type: array
          example:
          - example-lines
      required:
      - lines
      type: object
    CustomerCountResp_3:
      example:
        count: 0
      properties:
        count:
          format: int32
          type: integer
          example: 10
      required:
      - count
      type: object
    Current_admin_notification_messages_2:
      example:
        messages:
        - code: code
          htmlMessage: htmlMessage
        - code: code
          htmlMessage: htmlMessage
      properties:
        messages:
          description: Messages
          items:
            $ref: '#/components/schemas/Admin_notification_2'
          readOnly: true
          type: array
          example:
          - code: code
            htmlMessage: htmlMessage
      type: object
    SessionInfo_3:
      description: Session information
      example:
        apiToken: apiToken
        customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        apiTokenVersion: 0
        authToken: authToken
        userUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
      properties:
        apiToken:
          description: API token
          type: string
          example: REDACTED
        apiTokenVersion:
          description: API token version
          format: int64
          type: integer
          example: 1000
        authToken:
          description: Auth token
          type: string
          example: REDACTED
        customerUUID:
          description: Customer UUID
          format: uuid
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        userUUID:
          description: User UUID
          format: uuid
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
      type: object
    CustomerRegisterFormData_3:
      example:
        password: password
        code: code
        name: name
        email: email
      properties:
        code:
          type: string
          example: OK
        email:
          type: string
          example: admin@example.com
        name:
          type: string
          example: example-name
        password:
          type: string
          example: REDACTED
      required:
      - code
      - email
      - name
      - password
      type: object
    CustomerLoginFormData_3:
      example:
        password: password
        email: email
      properties:
        email:
          type: string
          example: admin@example.com
        password:
          type: string
          example: REDACTED
      required:
      - email
      - password
      type: object
    CustomerCountResp_4:
      example:
        count: 0
      properties:
        count:
          format: int32
          type: integer
          example: 10
      required:
      - count
      type: object
    LogData_4:
      example:
        lines:
        - lines
        - lines
      properties:
        lines:
          items:
            type: string
          type: array
          example:
          - example-lines
      required:
      - lines
      type: object
    SessionInfo_4:
      description: Session information
      example:
        apiToken: apiToken
        customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        apiTokenVersion: 0
        authToken: authToken
        userUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
      properties:
        apiToken:
          description: API token
          type: string
          example: REDACTED
        apiTokenVersion:
          description: API token version
          format: int64
          type: integer
          example: 1000
        authToken:
          description: Auth token
          type: string
          example: REDACTED
        customerUUID:
          description: Customer UUID
          format: uuid
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        userUUID:
          description: User UUID
          format: uuid
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
      type: object
    CustomerRegisterFormData_4:
      example:
        password: password
        code: code
        name: name
        email: email
      properties:
        code:
          type: string
          example: OK
        email:
          type: string
          example: admin@example.com
        name:
          type: string
          example: example-name
        password:
          type: string
          example: REDACTED
      required:
      - code
      - email
      - name
      - password
      type: object
  securitySchemes:
    apiKeyAuth:
      description: API token passed as header
      in: header
      name: X-AUTH-YW-API-TOKEN
      type: apiKey
externalDocs:
  description: About YugabyteDB Anywhere
  url: https://docs.yugabyte.com/latest/yugabyte-platform/
x-refined-from:
- openapi_2.yaml
- platform.swagger.json
- yugabytedb-anywhere-v1-full.yaml
- yugabytedb-anywhere-v1-users-rbac.yaml