ydb-qdrant-tech Discovery API

openapi: 3.2.0
info:
  title: Ydb Qdrant Tech Discovery API
  version: 1.0.0
  description: 'Operations tagged Discovery across 2 of this provider''s published API definitions: gravity-ai-openapi.json, pets-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://gravity-ai.ydb-qdrant.tech
- url: https://pets.ydb-qdrant.tech
tags:
- name: Discovery
  description: Agent-readable discovery metadata.
paths:
  /.well-known/mcp:
    get:
      operationId: getWellKnownMcpServerCard
      tags:
      - Discovery
      summary: Fetch the Gravity AI UI MCP server card
      responses:
        '200':
          description: JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpServerCard'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /.well-known/mcp.json:
    get:
      operationId: getMcpWellKnownDocument
      tags:
      - Discovery
      summary: Fetch MCP well-known compatibility metadata
      responses:
        '200':
          description: JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpWellKnownDocument'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /.well-known/agent.json:
    get:
      operationId: getAgentDiscovery
      tags:
      - Discovery
      summary: Fetch generic agent discovery metadata
      responses:
        '200':
          description: JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentDiscovery'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /openapi.json:
    get:
      operationId: getOpenApiSpec
      tags:
      - Discovery
      summary: Fetch the OpenAPI 3.1 document
      responses:
        '200':
          description: JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiDocument'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /.well-known/oauth-authorization-server:
    get:
      operationId: getOAuthAuthorizationServerMetadata
      tags:
      - Discovery
      summary: Fetch OAuth authorization server metadata
      responses:
        '200':
          description: JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthAuthorizationServerMetadata'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /.well-known/oauth-protected-resource:
    get:
      operationId: getOAuthProtectedResourceMetadata
      tags:
      - Discovery
      summary: Fetch OAuth protected-resource metadata
      responses:
        '200':
          description: JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthProtectedResourceMetadata'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /.well-known/oauth-protected-resource/mcp:
    get:
      operationId: getMcpOAuthProtectedResourceMetadata
      tags:
      - Discovery
      summary: Fetch MCP protected-resource metadata
      responses:
        '200':
          description: JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthProtectedResourceMetadata'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /.well-known/openid-configuration:
    get:
      operationId: getOpenIdConfiguration
      tags:
      - Discovery
      summary: Fetch OpenID Provider configuration
      responses:
        '200':
          description: JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenIdConfiguration'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /oauth/authorize:
    get:
      operationId: authorizeOAuthClient
      tags:
      - Discovery
      summary: OAuth authorization endpoint placeholder
      description: Returns structured oauth_not_enabled JSON while token issuance is disabled in the public demo.
      responses:
        '501':
          description: OAuth authorization is not enabled.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /oauth/token:
    post:
      operationId: issueOAuthToken
      tags:
      - Discovery
      summary: OAuth token endpoint placeholder
      description: Returns structured oauth_not_enabled JSON while token issuance is disabled in the public demo.
      responses:
        '501':
          description: OAuth token issuance is not enabled.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
    get:
      operationId: rejectOAuthTokenGet
      tags:
      - Discovery
      summary: Reject unsupported OAuth token GET requests
      responses:
        '405':
          description: OAuth token endpoint requires POST.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /oauth/userinfo:
    get:
      operationId: getOAuthUserInfo
      tags:
      - Discovery
      summary: OpenID UserInfo endpoint placeholder
      description: Returns structured oauth_not_enabled JSON while bearer-token enforcement is disabled in the public demo.
      responses:
        '501':
          description: OpenID UserInfo is not enabled.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
    post:
      operationId: postOAuthUserInfo
      tags:
      - Discovery
      summary: OpenID UserInfo endpoint placeholder
      description: Returns structured oauth_not_enabled JSON while bearer-token enforcement is disabled in the public demo.
      responses:
        '501':
          description: OpenID UserInfo is not enabled.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /api/openapi.json:
    get:
      operationId: getOpenApiSpecAlias
      tags:
      - Discovery
      summary: Get the Codex Pets OpenAPI specification alias
      description: Predictable API-prefixed alias for agents that probe /api/openapi.json.
      security: []
      responses:
        '200':
          description: Successful JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiDocument_2'
    servers:
    - url: https://pets.ydb-qdrant.tech
  /llms.txt:
    get:
      operationId: getLlmsTxt
      tags:
      - Discovery
      summary: Get concise LLM discovery context
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/plain:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /llms-full.txt:
    get:
      operationId: getLlmsFullTxt
      tags:
      - Discovery
      summary: Get full LLM-readable Codex Pets documentation
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/plain:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /index.md:
    get:
      operationId: getIndexMarkdown
      tags:
      - Discovery
      summary: Get markdown homepage fallback
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/markdown:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /about.md:
    get:
      operationId: getAboutMarkdown
      tags:
      - Discovery
      summary: Get markdown about page
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/markdown:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /agents.md:
    get:
      operationId: getAgentsMarkdown
      tags:
      - Discovery
      summary: Get markdown agent access guide
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/markdown:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /developers.md:
    get:
      operationId: getDevelopersMarkdown
      tags:
      - Discovery
      summary: Get markdown developer portal
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/markdown:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /developers/llms.txt:
    get:
      operationId: getDevelopersLlmsTxt
      tags:
      - Discovery
      summary: Get scoped developer LLM discovery context
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/plain:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /docs/api.md:
    get:
      operationId: getApiDocsMarkdown
      tags:
      - Discovery
      summary: Get markdown API docs
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/markdown:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /docs/llms.txt:
    get:
      operationId: getDocsLlmsTxt
      tags:
      - Discovery
      summary: Get scoped API LLM discovery context
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/plain:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /mcp.md:
    get:
      operationId: getMcpMarkdown
      tags:
      - Discovery
      summary: Get markdown MCP server guide
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/markdown:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /auth.md:
    get:
      operationId: getAuthMarkdown
      tags:
      - Discovery
      summary: Get markdown auth notes
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/markdown:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /pricing:
    get:
      operationId: getPricingPage
      tags:
      - Discovery
      summary: Get Codex Pets pricing page
      description: Human-readable pricing page. Codex Pets public registry access is free and best-effort with no paid plans or SLA.
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/html:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /pricing.md:
    get:
      operationId: getPricingMarkdown
      tags:
      - Discovery
      summary: Get markdown pricing notes
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/markdown:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /terms:
    get:
      operationId: getTermsPage
      tags:
      - Discovery
      summary: Get Codex Pets terms page
      description: Human-readable public use terms, moderation notes, and versioning policy.
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/html:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /terms.md:
    get:
      operationId: getTermsMarkdown
      tags:
      - Discovery
      summary: Get markdown public use terms
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/markdown:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
components:
  schemas:
    ProblemDetails:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
            message:
              type: string
            docs:
              type: string
              format: uri
            issues: {}
    OpenIdConfiguration:
      allOf:
      - $ref: '#/components/schemas/OAuthAuthorizationServerMetadata'
      - type: object
        required:
        - userinfo_endpoint
        - subject_types_supported
        - id_token_signing_alg_values_supported
        - claims_supported
        properties:
          userinfo_endpoint:
            type: string
            format: uri
          subject_types_supported:
            type: array
            items:
              type: string
          id_token_signing_alg_values_supported:
            type: array
            items:
              type: string
          claims_supported:
            type: array
            items:
              type: string
    OpenApiDocument:
      type: object
      description: OpenAPI 3.1 document.
    McpServerCard:
      type: object
      additionalProperties: false
      required:
      - name
      - title
      - description
      - version
      - websiteUrl
      - serverUrl
      - transport
      - tools
      properties:
        name:
          type: string
        title:
          type: string
        description:
          type: string
        version:
          type: string
        websiteUrl:
          type: string
          format: uri
        serverUrl:
          type: string
          format: uri
        transport:
          type: string
          const: streamable-http
        tools:
          type: array
          items:
            type: object
            additionalProperties: false
            required:
            - name
            - title
            - description
            - readOnly
            properties:
              name:
                type: string
              title:
                type: string
              description:
                type: string
              readOnly:
                type: boolean
    OAuthAuthorizationServerMetadata:
      type: object
      required:
      - issuer
      - authorization_endpoint
      - token_endpoint
      - jwks_uri
      - response_types_supported
      - grant_types_supported
      - token_endpoint_auth_methods_supported
      - code_challenge_methods_supported
      - scopes_supported
      - service_documentation
      properties:
        issuer:
          type: string
          format: uri
        authorization_endpoint:
          type: string
          format: uri
        token_endpoint:
          type: string
          format: uri
        jwks_uri:
          type: string
          format: uri
        response_types_supported:
          type: array
          items:
            type: string
        grant_types_supported:
          type: array
          items:
            type: string
        token_endpoint_auth_methods_supported:
          type: array
          items:
            type: string
        code_challenge_methods_supported:
          type: array
          items:
            type: string
        scopes_supported:
          type: array
          items:
            type: string
        service_documentation:
          type: string
          format: uri
    McpWellKnownDocument:
      type: object
      required:
      - name
      - title
      - description
      - version
      - websiteUrl
      - serverUrl
      - serverCard
      - openapi
      - transport
      - tools
      - servers
      properties:
        name:
          type: string
        title:
          type: string
        description:
          type: string
        version:
          type: string
        websiteUrl:
          type: string
          format: uri
        serverUrl:
          type: string
          format: uri
        serverCard:
          type: string
          format: uri
        openapi:
          type: string
          format: uri
        transport:
          type: string
          const: streamable-http
        tools:
          type: array
          items:
            type: object
        servers:
          type: array
          items:
            type: object
    AgentDiscovery:
      type: object
      required:
      - name
      - description
      - url
      - openapi
      - mcp
      - capabilities
      properties:
        name:
          type: string
        description:
          type: string
        url:
          type: string
          format: uri
        documentation:
          type: string
          format: uri
        openapi:
          type: string
          format: uri
        llms:
          type: string
          format: uri
        markdown:
          type: string
          format: uri
        oauth:
          type: object
        mcp:
          type: object
        capabilities:
          type: array
          items:
            type: string
    OAuthProtectedResourceMetadata:
      type: object
      required:
      - resource
      properties:
        resource:
          type: string
          format: uri
        authorization_servers:
          type: array
          items:
            type: string
        scopes_supported:
          type: array
          items:
            type: string
        bearer_methods_supported:
          type: array
          items:
            type: string
        resource_name:
          type: string
        resource_documentation:
          type: string
          format: uri
    OpenApiDocument_2:
      type: object
      additionalProperties: true
    OAuthProtectedResourceMetadata_2:
      type: object
      required:
      - resource
      - resource_name
      - resource_documentation
      - resource_policy_uri
      - resource_tos_uri
      - oauth_unsupported
      - scopes_supported
      - bearer_methods_supported
      properties:
        resource:
          type: string
          format: uri
        resource_name:
          type: string
        resource_documentation:
          type: string
          format: uri
        resource_policy_uri:
          type: string
          format: uri
        resource_tos_uri:
          type: string
          format: uri
        oauth_unsupported:
          type: boolean
          const: true
        scopes_supported:
          type: array
          items:
            type: string
          maxItems: 0
        bearer_methods_supported:
          type: array
          items:
            type: string
          maxItems: 0
      additionalProperties: true
  securitySchemes:
    OAuth2Metadata:
      type: oauth2
      description: Discovery metadata is published for agent compatibility. Token issuance is disabled in the current public demo.
      flows:
        authorizationCode:
          authorizationUrl: https://gravity-ai.ydb-qdrant.tech/oauth/authorize
          tokenUrl: https://gravity-ai.ydb-qdrant.tech/oauth/token
          scopes:
            interface:generate: Generate and refine interfaces.
            interface:read: Read public gallery interfaces.
    AppSessionCookie:
      type: apiKey
      in: cookie
      name: codex_pets_session
      description: Optional app-session cookie used by browser account flows. Public read endpoints do not require it.
    ProxyBasic:
      type: http
      scheme: basic
      description: Deployment mode for trusted reverse proxies. Public agent endpoints are designed to be readable without credentials.
x-refined-from:
- gravity-ai-openapi.json
- pets-openapi.json