---
title: "Create Provider Discovery"
method: POST
path: "/api/v1/providers/discovery"
tags: ["provider_discovery"]
---

# Create Provider Discovery

`POST /api/v1/providers/discovery`

## Request body

- CreateDiscoveryRequest
  - `docker_image` string, required

## Response `200`

Successful Response

- ProviderDiscovery
  - `id` string, uuid
  - `created_at` string, date-time
  - `status` 'pending' | 'in_progress' | 'completed' | 'failed', required
  - `docker_image` string, required
  - `created_by` string, uuid, required
  - `agent_card` AgentCardOutput — 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.
    - `additionalInterfaces` AgentInterface[], nullable
      - `transport` string, required
      - `url` string, required
    - `capabilities` AgentCapabilities, required — Defines optional capabilities supported by an agent.
      - `extensions` AgentExtension[], nullable
        - `description` string, nullable
        - `params` object, nullable
        - `required` boolean, nullable
        - `uri` string, required
      - `pushNotifications` boolean, nullable
      - `stateTransitionHistory` boolean, nullable
      - `streaming` boolean, nullable
    - `defaultInputModes` string[], required
    - `defaultOutputModes` string[], required
    - `description` string, required
    - `documentationUrl` string, nullable
    - `iconUrl` string, nullable
    - `name` string, required
    - `preferredTransport` string, nullable
    - `protocolVersion` string, nullable
    - `provider` AgentProvider — Represents the service provider of an agent.
      - `organization` string, required
      - `url` string, required
    - `security` object[], nullable
    - `securitySchemes` object, nullable
    - `signatures` AgentCardSignature[], nullable
      - `header` object, nullable
      - `protected` string, required
      - `signature` string, required
    - `skills` AgentSkill[], required
      - `description` string, required
      - `examples` string[], nullable
      - `id` string, required
      - `inputModes` string[], nullable
      - `name` string, required
      - `outputModes` string[], nullable
      - `security` object[], nullable
      - `tags` string[], required
    - `supportsAuthenticatedExtendedCard` boolean, nullable
    - `url` string, required
    - `version` string, required
  - `error_message` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/i-am-bee/apis/agentstack-server.md) · [All operations](https://skmtc.net/i-am-bee/apis/agentstack-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/i-am-bee/agentstack-server/revisions/7d68b3f8bf7f/schema)