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

# Get an agent's public A2A Agent Card (legacy path)

> Legacy A2A v0.2 alias for Agent Card discovery, serving the identical payload as /.well-known/agent-card.json for federation peers that have not migrated to the newer filename. Resolves the tenant from the required 'tenant' query parameter and returns 404 unless the agent's discovery mode is public.



## OpenAPI

````yaml /openapi.yaml get /api/v1/agents/{id}/.well-known/agent.json
openapi: 3.1.0
info:
  title: Devotel CPaaS API
  description: Orbit by Devotel — Communications Platform as a Service API
  version: 1.0.0
  contact:
    name: Devotel
    url: https://devotel.io
    email: support@devotel.io
  license:
    name: Proprietary
servers:
  - url: https://api.orbit.devotel.io
    description: Production
security:
  - Bearer: []
  - ApiKey: []
tags:
  - name: Messages
    description: >-
      Send and manage messages across all channels (SMS, WhatsApp, RCS, Email,
      Viber, etc.)
  - name: Fax
    description: >-
      List and track fax (MMS/T.38) transmissions on Telnyx-backed fax numbers
      (sending flows through the Messaging API)
  - name: Agents
    description: AI agent creation, configuration, and execution
  - name: Voice
    description: Voice calls, IVR, conferencing, and SIP trunking
  - name: OnCall
    description: On-call rotations and escalation policy planning for incident alerting
  - name: Webhooks
    description: Webhook endpoint management and delivery logs
  - name: Numbers
    description: Phone number search, provisioning, and configuration
  - name: Brand Identity
    description: >-
      Unified cross-channel brand trust posture (10DLC, toll-free, WhatsApp,
      RCS, branded calling, number KYC)
  - name: Contacts
    description: Contact management, segmentation, and lifecycle tracking
  - name: Campaigns
    description: Marketing campaign orchestration and analytics
  - name: Flows
    description: Automation flow builder and execution engine
  - name: Templates
    description: Message template management and approval workflows
  - name: Settings
    description: Organization, channel, and user preference settings
  - name: Verify
    description: OTP generation and verification across channels
  - name: Push
    description: Push notification delivery via FCM and APNs
  - name: Integrations
    description: Third-party service connections and OAuth management
  - name: CDP
    description: >-
      Customer Data Platform — activation surface (CRM object sync, streaming
      destinations, ad-audience activation)
  - name: Files
    description: >-
      Server-to-server media upload, listing, retrieval, and deletion
      (signed-URL backed)
  - name: Commerce
    description: >-
      Omnichannel conversational-commerce — persistent cart + checkout state
      machine, channel-agnostic hosted pay-by-link, native WhatsApp checkout,
      and AP2-style agent payment mandates.
  - name: Sync
    description: >-
      Real-time shared-state primitive (Twilio Sync parity) — Documents, Maps,
      Lists, and ephemeral Streams, with change events relayed over the
      /api/v1/ws/sync WebSocket gateway
paths:
  /api/v1/agents/{id}/.well-known/agent.json:
    get:
      tags:
        - Agents
      summary: Get an agent's public A2A Agent Card (legacy path)
      description: >-
        Legacy A2A v0.2 alias for Agent Card discovery, serving the identical
        payload as /.well-known/agent-card.json for federation peers that have
        not migrated to the newer filename. Resolves the tenant from the
        required 'tenant' query parameter and returns 404 unless the agent's
        discovery mode is public.
      parameters:
        - schema:
            type: string
          in: path
          name: id
          required: true
      responses:
        '200':
          description: The agent's A2A Agent Card
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  name:
                    type: string
                  description:
                    type: string
                  url:
                    type: string
                    format: uri
                  version:
                    type: string
                  protocolVersion:
                    type: string
                  skills:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  authentication:
                    type: object
                    additionalProperties: true
                  metadata:
                    type: object
                    additionalProperties: true
              example:
                name: Support Concierge
                description: >-
                  Answers billing and account questions and hands off to a human
                  when needed.
                url: https://api.orbit.devotel.io/agents/agent_9f2c/a2a/tasks
                version: 0.1.0
                protocolVersion: 0.3.0
                skills:
                  - id: chat
                    name: Chat
                    description: >-
                      Multi-turn conversation answering questions and providing
                      support.
                    tags:
                      - chat
                      - support
                authentication:
                  type: api_key
                  header: X-A2A-Signature
                metadata:
                  agentId: agent_9f2c
                  agentType: chatbot
                  provider:
                    name: Orbit by Devotel
                    url: https://orbit.devotel.io
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Dashboard JWT token from Clerk
    ApiKey:
      type: apiKey
      name: X-API-Key
      in: header
      description: Server-to-server API key (dv_live_sk_*)

````