Skip to main content
POST
/
api
/
v1
/
providers
/
discovery
Create Provider Discovery
curl --request POST \
  --url https://api.example.com/api/v1/providers/discovery \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "docker_image": "<string>"
}
'
{
  "docker_image": "<string>",
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "agent_card": {
    "capabilities": {
      "extensions": [
        {
          "uri": "<string>",
          "description": "<string>",
          "params": {},
          "required": true
        }
      ],
      "pushNotifications": true,
      "stateTransitionHistory": true,
      "streaming": true
    },
    "defaultInputModes": [
      "<string>"
    ],
    "defaultOutputModes": [
      "<string>"
    ],
    "description": "<string>",
    "name": "<string>",
    "skills": [
      {
        "description": "<string>",
        "id": "<string>",
        "name": "<string>",
        "tags": [
          "<string>"
        ],
        "examples": [
          "I need a recipe for bread"
        ],
        "inputModes": [
          "<string>"
        ],
        "outputModes": [
          "<string>"
        ],
        "security": [
          {
            "google": [
              "oidc"
            ]
          }
        ]
      }
    ],
    "url": "<string>",
    "version": "<string>",
    "additionalInterfaces": [
      {
        "transport": "<string>",
        "url": "<string>"
      }
    ],
    "documentationUrl": "<string>",
    "iconUrl": "<string>",
    "preferredTransport": "JSONRPC",
    "protocolVersion": "0.3.0",
    "provider": {
      "organization": "<string>",
      "url": "<string>"
    },
    "security": [
      {
        "oauth": [
          "read"
        ]
      },
      {
        "api-key": [],
        "mtls": []
      }
    ],
    "securitySchemes": {},
    "signatures": [
      {
        "protected": "<string>",
        "signature": "<string>",
        "header": {}
      }
    ],
    "supportsAuthenticatedExtendedCard": true
  },
  "error_message": "<string>"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
​
docker_image
string
required

Response

Successful Response

​
status
enum<string>
required
Available options:
pending,
in_progress,
completed,
failed
​
docker_image
string
required
​
created_by
string<uuid>
required
​
id
string<uuid>
​
created_at
string<date-time>
​
agent_card
AgentCard · object

The AgentCard is a self-describing manifest for an agent. It provides essential metadata including the agent's identity, capabilities, skills, supported communication methods, and security requirements.

​
error_message
string | null