> ## Documentation Index
> Fetch the complete documentation index at: https://actelos.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get registry auth

> Returns the currently configured auth for a registry together with the oauth2 scopes offered by its current well-known advertisement. The advertisement is fetched live; scopes are never cached.



## OpenAPI

````yaml /openapi.json get /registries/{id}/auth
openapi: 3.0.0
info:
  title: Cyrnel API
  description: >-
    Cyrnel is a universal layer that connects AI agents and LLM applications to
    any external service, API, or device regardless of protocol or standard. It
    acts as an adaptive bridge between your AI and the outside world, enabling
    seamless integrations through code execution, async operation handling, and
    built-in observability and security controls.
  version: 1.0.0
servers:
  - url: http://localhost:9371
security: []
paths:
  /registries/{id}/auth:
    get:
      tags:
        - Registries
      summary: Get registry auth
      description: >-
        Returns the currently configured auth for a registry together with the
        oauth2 scopes offered by its current well-known advertisement. The
        advertisement is fetched live; scopes are never cached.
      parameters:
        - schema:
            type: string
            minLength: 1
            description: Registry slug identifying the registry.
          required: true
          description: Registry slug identifying the registry.
          name: id
          in: path
      responses:
        '200':
          description: The registry auth configuration.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegistryAuthReadResponse'
        '400':
          description: The id path parameter was invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: A bearer token was required but missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '404':
          description: The registry could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: The auth configuration could not be loaded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '502':
          description: The registry's well-known document could not be reached.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    RegistryAuthReadResponse:
      type: object
      properties:
        authType:
          type: string
          nullable: true
          enum:
            - apiKey
            - oauth2
            - null
        tokenEndpoint:
          type: string
          nullable: true
        headerName:
          type: string
          nullable: true
        tokenExpiresAt:
          type: number
          nullable: true
        availableScopes:
          type: array
          items:
            $ref: '#/components/schemas/RegistryAuthAvailableScope'
          description: >-
            Scopes advertised by the registry's current well-known document when
            it advertises oauth2 auth, regardless of whether auth is configured;
            empty otherwise.
        configuredScopes:
          type: array
          items:
            type: string
          description: Scopes currently configured for the registry.
      required:
        - authType
        - tokenEndpoint
        - headerName
        - tokenExpiresAt
        - availableScopes
        - configuredScopes
      description: >-
        Current auth configuration for a registry and the oauth2 scopes its
        advertisement offers.
    ApiErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message returned by the API.
        code:
          type: string
          description: >-
            Stable machine-readable error code (e.g. invalid_cursor,
            cursor_expired).
      required:
        - error
      description: Standard error envelope returned by the HTTP error middleware.
    RegistryAuthAvailableScope:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          description: Scope identifier.
        description:
          type: string
          description: Human-readable description of what the scope permits.
      required:
        - id
      description: A scope offered by the registry's oauth2 auth advertisement.

````