Archestra AI

Archestra AI A2A API

The A2A API from Archestra AI — 5 operation(s) for a2a.

GitHub OpenAPI

Operations 5

GET /v1/a2a/{agentId}/.well-known/agent.json Get a2a by agent id well known agent json #
POST /v1/a2a/{agentId} Create a2a by agent id #
GET /v2/a2a/agents Get a2a agents #
GET /v2/a2a/{agentId}/.well-known/agent-card.json Get a2a by agent id well known agent card json #
POST /v2/a2a/{agentId} Create a2a by agent id #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/archestra/openapi/archestra-a2a-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/archestra/json-schema/archestra-gemini-generate-content-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/archestra/json-schema/archestra-gemini-generate-content-request-input-schema.json
📊
JSONSchema
https://artifacts.apis.io/archestra/json-schema/archestra-minimax-chat-completion-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/archestra/json-schema/archestra-minimax-chat-completion-request-input-schema.json
📊
JSONSchema
https://artifacts.apis.io/archestra/json-schema/archestra-openrouter-chat-completion-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/archestra/json-schema/archestra-perplexity-chat-completion-request-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/archestra/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/archestra:archestra-a2a-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

archestra-a2a-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Archestra A2A API
  version: 1.4.0-rc.47
tags:
- name: a2a
paths:
  /v1/a2a/{agentId}/.well-known/agent.json:
    get:
      tags:
      - a2a
      description: Get A2A AgentCard for an internal agent (must be agentType='agent')
      parameters:
      - schema:
          type: string
          format: uuid
          pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        in: path
        name: agentId
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                  description:
                    type: string
                  url:
                    type: string
                  version:
                    type: string
                  capabilities:
                    type: object
                    properties:
                      streaming:
                        type: boolean
                      pushNotifications:
                        type: boolean
                      stateTransitionHistory:
                        type: boolean
                    required:
                    - streaming
                    - pushNotifications
                    - stateTransitionHistory
                    additionalProperties: false
                  defaultInputModes:
                    type: array
                    items:
                      type: string
                  defaultOutputModes:
                    type: array
                    items:
                      type: string
                  skills:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        description:
                          type: string
                        tags:
                          type: array
                          items:
                            type: string
                        inputModes:
                          type: array
                          items:
                            type: string
                        outputModes:
                          type: array
                          items:
                            type: string
                      required:
                      - id
                      - name
                      - description
                      - tags
                      - inputModes
                      - outputModes
                      additionalProperties: false
                required:
                - name
                - description
                - url
                - version
                - capabilities
                - defaultInputModes
                - defaultOutputModes
                - skills
                additionalProperties: false
      summary: Get a2a by agent id well known agent json
      x-summary-source: derived
      operationId: getV1A2aByAgentIdWellKnownAgentJson
      x-operation-id-source: derived
  /v1/a2a/{agentId}:
    post:
      tags:
      - a2a
      description: Execute A2A message on an internal agent (must be agentType='agent'). Accepts a JSON-RPC envelope or any JSON payload — non-JSON-RPC payloads are stringified and passed through to the agent as the user message.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                properties:
                  jsonrpc:
                    type: string
                    enum:
                    - '2.0'
                  id:
                    anyOf:
                    - type: string
                    - type: number
                  method:
                    type: string
                  params:
                    type: object
                    properties:
                      message:
                        type: object
                        properties:
                          parts:
                            type: array
                            items:
                              type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                  - text
                                text:
                                  type: string
                              required:
                              - kind
                              - text
                required:
                - jsonrpc
                - id
                - method
      parameters:
      - schema:
          type: string
          format: uuid
          pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        in: path
        name: agentId
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    enum:
                    - '2.0'
                  id:
                    anyOf:
                    - type: string
                    - type: number
                  result:
                    type: object
                    properties:
                      messageId:
                        type: string
                      role:
                        type: string
                        enum:
                        - user
                        - agent
                      parts:
                        type: array
                        items:
                          type: object
                          properties:
                            kind:
                              type: string
                              enum:
                              - text
                            text:
                              type: string
                          required:
                          - kind
                          - text
                          additionalProperties: false
                      contextId:
                        type: string
                      taskId:
                        type: string
                      metadata:
                        type: object
                        additionalProperties: {}
                    required:
                    - messageId
                    - role
                    - parts
                    additionalProperties: false
                  error:
                    type: object
                    properties:
                      code:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                    - code
                    - message
                    additionalProperties: false
                required:
                - jsonrpc
                - id
                additionalProperties: false
      summary: Create a2a by agent id
      x-summary-source: derived
      operationId: postV1A2aByAgentId
      x-operation-id-source: derived
  /v2/a2a/agents:
    get:
      tags:
      - a2a
      description: List the A2A AgentCards the presented credential is allowed to reach
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  agents:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        description:
                          type: string
                        version:
                          type: string
                        documentationUrl:
                          type: string
                        provider:
                          type: object
                          properties:
                            url:
                              type: string
                            organization:
                              type: string
                          required:
                          - url
                          - organization
                          additionalProperties: false
                        supportedInterfaces:
                          type: array
                          items:
                            type: object
                            properties:
                              url:
                                type: string
                              protocolBinding:
                                type: string
                              protocolVersion:
                                type: string
                            required:
                            - url
                            - protocolBinding
                            - protocolVersion
                            additionalProperties: false
                        capabilities:
                          type: object
                          properties:
                            streaming:
                              type: boolean
                            pushNotifications:
                              type: boolean
                            extendedAgentCard:
                              type: boolean
                          required:
                          - streaming
                          - pushNotifications
                          - extendedAgentCard
                          additionalProperties: false
                        securitySchemes:
                          type: object
                          additionalProperties:
                            type: object
                            properties:
                              type:
                                type: string
                              scheme:
                                type: string
                              bearerFormat:
                                type: string
                              description:
                                type: string
                            required:
                            - type
                            additionalProperties: false
                        securityRequirements:
                          type: array
                          items:
                            type: object
                            additionalProperties:
                              type: array
                              items:
                                type: string
                        defaultInputModes:
                          type: array
                          items:
                            type: string
                        defaultOutputModes:
                          type: array
                          items:
                            type: string
                        skills:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              name:
                                type: string
                              description:
                                type: string
                              tags:
                                type: array
                                items:
                                  type: string
                              examples:
                                type: array
                                items:
                                  type: string
                              inputModes:
                                type: array
                                items:
                                  type: string
                              outputModes:
                                type: array
                                items:
                                  type: string
                            required:
                            - id
                            - name
                            - description
                            - tags
                            - inputModes
                            - outputModes
                            additionalProperties: false
                      required:
                      - name
                      - description
                      - version
                      - provider
                      - supportedInterfaces
                      - capabilities
                      - securitySchemes
                      - securityRequirements
                      - defaultInputModes
                      - defaultOutputModes
                      - skills
                      additionalProperties: false
                required:
                - agents
                additionalProperties: false
      summary: Get a2a agents
      x-summary-source: derived
      operationId: getV2A2aAgents
      x-operation-id-source: derived
  /v2/a2a/{agentId}/.well-known/agent-card.json:
    get:
      tags:
      - a2a
      description: Get A2A AgentCard for an internal agent (must be agentType='agent')
      parameters:
      - schema:
          type: string
          format: uuid
          pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        in: path
        name: agentId
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                  description:
                    type: string
                  version:
                    type: string
                  documentationUrl:
                    type: string
                  provider:
                    type: object
                    properties:
                      url:
                        type: string
                      organization:
                        type: string
                    required:
                    - url
                    - organization
                    additionalProperties: false
                  supportedInterfaces:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                        protocolBinding:
                          type: string
                        protocolVersion:
                          type: string
                      required:
                      - url
                      - protocolBinding
                      - protocolVersion
                      additionalProperties: false
                  capabilities:
                    type: object
                    properties:
                      streaming:
                        type: boolean
                      pushNotifications:
                        type: boolean
                      extendedAgentCard:
                        type: boolean
                    required:
                    - streaming
                    - pushNotifications
                    - extendedAgentCard
                    additionalProperties: false
                  securitySchemes:
                    type: object
                    additionalProperties:
                      type: object
                      properties:
                        type:
                          type: string
                        scheme:
                          type: string
                        bearerFormat:
                          type: string
                        description:
                          type: string
                      required:
                      - type
                      additionalProperties: false
                  securityRequirements:
                    type: array
                    items:
                      type: object
                      additionalProperties:
                        type: array
                        items:
                          type: string
                  defaultInputModes:
                    type: array
                    items:
                      type: string
                  defaultOutputModes:
                    type: array
                    items:
                      type: string
                  skills:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        description:
                          type: string
                        tags:
                          type: array
                          items:
                            type: string
                        examples:
                          type: array
                          items:
                            type: string
                        inputModes:
                          type: array
                          items:
                            type: string
                        outputModes:
                          type: array
                          items:
                            type: string
                      required:
                      - id
                      - name
                      - description
                      - tags
                      - inputModes
                      - outputModes
                      additionalProperties: false
                required:
                - name
                - description
                - version
                - provider
                - supportedInterfaces
                - capabilities
                - securitySchemes
                - securityRequirements
                - defaultInputModes
                - defaultOutputModes
                - skills
                additionalProperties: false
        '304':
          description: Default Response
      summary: Get a2a by agent id well known agent card json
      x-summary-source: derived
      operationId: getV2A2aByAgentIdWellKnownAgentCardJson
      x-operation-id-source: derived
  /v2/a2a/{agentId}:
    post:
      tags:
      - a2a
      description: Main A2A JSON-RPC endpoint
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  enum:
                  - '2.0'
                id:
                  anyOf:
                  - type: string
                  - type: number
                method:
                  type: string
                params: {}
              required:
              - jsonrpc
              - id
              - method
      parameters:
      - schema:
          type: string
          format: uuid
          pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        in: path
        name: agentId
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    enum:
                    - '2.0'
                  id:
                    anyOf:
                    - type: string
                    - type: number
                  result: {}
                  error:
                    type: object
                    properties:
                      code:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                    - code
                    - message
                    additionalProperties: false
                required:
                - jsonrpc
                - id
                additionalProperties: false
      summary: Create a2a by agent id
      x-summary-source: derived
      operationId: postV2A2aByAgentId
      x-operation-id-source: derived