Preview Provider

Request body

variablesobject nullable

originstring nullable

A unique origin of the provider: most often a docker or github repository url (without tag). This is used to determine multiple versions of the same agent.

auto_stop_timeout_secinteger nullable

Timeout after which the agent provider will be automatically downscaled if unused.Contact administrator if you need to increase this value.

Example request

{
  "agent_card": {
    "additionalInterfaces": [
      {
        "transport": "JSONRPC",
        "url": "https://api.example.com/a2a/v1"
      }
    ],
    "description": "Agent that helps users with recipes and cooking.",
    "name": "Recipe Agent",
    "preferredTransport": "JSONRPC",
    "security": [
      {
        "oauth": [
          "read"
        ]
      },
      {
        "api-key": [],
        "mtls": []
      }
    ],
    "skills": [
      {
        "examples": [
          "I need a recipe for bread"
        ],
        "security": [
          {
            "google": [
              "oidc"
            ]
          }
        ],
        "tags": [
          "cooking",
          "customer support",
          "billing"
        ]
      }
    ],
    "url": "https://api.example.com/a2a/v1",
    "version": "1.0.0"
  }
}

Response

Successful Response

idstring uuid

auto_stop_timeoutstring duration

originstring required

created_atstring date-time

updated_atstring date-time

created_bystring uuid required

last_active_atstring date-time

type'managed' | 'unmanaged' required

managedboolean required

Example response

{
  "agent_card": {
    "additionalInterfaces": [
      {
        "transport": "JSONRPC",
        "url": "https://api.example.com/a2a/v1"
      }
    ],
    "description": "Agent that helps users with recipes and cooking.",
    "name": "Recipe Agent",
    "preferredTransport": "JSONRPC",
    "security": [
      {
        "oauth": [
          "read"
        ]
      },
      {
        "api-key": [],
        "mtls": []
      }
    ],
    "skills": [
      {
        "examples": [
          "I need a recipe for bread"
        ],
        "security": [
          {
            "google": [
              "oidc"
            ]
          }
        ],
        "tags": [
          "cooking",
          "customer support",
          "billing"
        ]
      }
    ],
    "url": "https://api.example.com/a2a/v1",
    "version": "1.0.0"
  }
}