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

# Get a realm's agent card

> Returns the realm's A2A agent card (name, URL, protocol version, skills). Public; cached for 60 seconds. Only realms with A2A turned on have one.

No authentication: anyone can call this. Card only for realms with A2A enabled.



## OpenAPI

````yaml /openapi/hub-by-tag/hub-a2a.yaml get /a2a/o/{org}/r/{slug}/.well-known/agent-card.json
openapi: 3.0.3
info:
  title: 'CliqHub API: A2A'
  version: 1.0.0
  description: >-
    Agent-to-agent (A2A) access to a realm. Outside agents read the realm's
    agent card to see

    its skills (one per team the realm runs), then send tasks with JSON-RPC to
    `send`, using the

    realm's A2A token. A2A must be turned on for the realm (Realms, Manage A2A
    for a realm).
servers:
  - url: https://{host}
    variables:
      host:
        default: cliqhub.io
        description: CliqHub host
security: []
tags:
  - name: A2A
    description: >-
      Agent-to-agent (A2A) access to a realm. Outside agents read the realm's
      agent card to see

      its skills (one per team the realm runs), then send tasks with JSON-RPC to
      `send`, using the

      realm's A2A token. A2A must be turned on for the realm (Realms, Manage A2A
      for a realm).
paths:
  /a2a/o/{org}/r/{slug}/.well-known/agent-card.json:
    get:
      tags:
        - A2A
      summary: Get a realm's agent card
      description: >-
        Returns the realm's A2A agent card (name, URL, protocol version,
        skills). Public; cached for 60 seconds. Only realms with A2A turned on
        have one.


        No authentication: anyone can call this. Card only for realms with A2A
        enabled.
      operationId: GET_a2a_o_org_r_slug_well_known_agent_card_json
      parameters:
        - name: org
          in: path
          required: true
          schema:
            type: string
          description: The organization's slug.
        - name: slug
          in: path
          required: true
          schema:
            type: string
          description: The realm's slug.
      responses:
        '200':
          description: The agent card itself (not wrapped in `{ ok, data }`).
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    enum:
                      - true
                    description: Always `true` on success.
                  name:
                    type: string
                  description:
                    type: string
                  url:
                    type: string
                    description: Where to send tasks.
                  version:
                    type: string
                  protocolVersion:
                    type: string
                  skills:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        description:
                          type: string
                required:
                  - ok
              example:
                ok: true
                name: Production
                description: CliqHub realm agent for acme.production
                url: https://api.cliqhub.io/a2a/o/acme/r/production/send
                version: 1.0.0
                protocolVersion: 0.3.0
                skills:
                  - id: acme/code-review
                    name: code-review
                    description: Reviews a pull request and posts findings.
        '404':
          description: >-
            `not_found`: No realm has this slug in the organization, or A2A is
            not turned on for it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HubErr'
              examples:
                not_found:
                  summary: not_found
                  value:
                    ok: false
                    error: A2A is not enabled for realm 'production'
                    code: not_found
        '500':
          description: >-
            `internal_error`: An unexpected server fault. Retry later; if it
            persists, report it with the time of the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HubErr'
              examples:
                internal_error:
                  summary: internal_error
                  value:
                    ok: false
                    error: Internal server error
                    code: internal_error
      security: []
components:
  schemas:
    HubErr:
      type: object
      required:
        - ok
        - error
      description: >-
        Every failure. Route-policy denials (401/403/404, and 400 when neither
        realm_id nor org_id was sent) answer `error` as `{ code, message }`;
        errors raised by the endpoint answer `error` as the message with the
        code beside it in `code`. Every error has a code. See
        [Errors](/hub-api/errors).
      properties:
        ok:
          type: boolean
          description: Always false on error
        error:
          description: The message, or `{ code, message }` for an access denial.
          oneOf:
            - type: string
            - type: object
              required:
                - code
                - message
              properties:
                code:
                  type: string
                message:
                  type: string
        code:
          type: string
          description: Stable error code of an endpoint error.
        details:
          type: object
          additionalProperties: true
          description: Structured detail, when there is some.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.