> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qumo-deploy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introspect a Relay Credential

> Internal relay-mesh endpoint authenticated by the configured mesh credential.



## OpenAPI

````yaml /api-reference/openapi.yaml post /v1/credentials/introspect
openapi: 3.1.0
info:
  title: Qumo Deploy REST API
  description: >
    The Qumo Deploy REST API provides programmatic control over edge relay
    clusters,

    ephemeral Relay Credential issuance, tenant lifecycle, machine identities,
    and billing.

    Authentication is operation-specific: Relay Keys authenticate relay access
    operations,

    while user sessions and Identity Tokens authenticate control-plane
    operations.
  version: 1.0.0
servers:
  - url: https://api.qumo-deploy.com
    description: Production Control Plane
  - url: http://localhost:8080
    description: Local Development / Sandbox
security:
  - BearerAuth: []
paths:
  /v1/credentials/introspect:
    post:
      summary: Introspect a Relay Credential
      description: >-
        Internal relay-mesh endpoint authenticated by the configured mesh
        credential.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - token
              properties:
                token:
                  type: string
      responses:
        '200':
          description: Credential validity and relay attribution
          content:
            application/json:
              schema:
                type: object
                required:
                  - valid
                properties:
                  valid:
                    type: boolean
                  token_id:
                    type: string
                  project_id:
                    type: string
                  tenant_id:
                    type: string
                  api_key_id:
                    type: string
                  environment:
                    type: string
                  revalidate_after:
                    type: string
                    format: date-time
      security: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: SessionOrIdentityToken
      description: |
        User session or Identity Token. Relay Keys are not accepted.

````