Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-3089191317.6 KB
providers

Patch Provider

patch/api/v1/providers/{id}

Path parameters

idstring uuid required

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. None means that origin will be recomputed from location. To preserve original value, set it explicitly.

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"
  }
}