---
title: "Patch Provider"
method: PATCH
path: "/api/v1/providers/{id}"
tags: ["providers"]
---

# Patch Provider

`PATCH /api/v1/providers/{id}`

## Path parameters

- `id` string, uuid, required

## Request body

- PatchProviderRequest
  - `location` union
    - string
    - string, uri
  - `agent_card` AgentCardInput — 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
  - `variables` object, nullable
  - `origin` string, 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_sec` integer, nullable — Timeout after which the agent provider will be automatically downscaled if unused.Contact administrator if you need to increase this value.

## Response `200`

Successful Response

- ProviderWithState
  - `source` union, required
    - string
    - string, uri
  - `id` string, uuid
  - `auto_stop_timeout` string, duration
  - `origin` string, required
  - `version_info` VersionInfo
    - `docker` ResolvedDockerImageID
      - `registry` string, required
      - `repository` string, required
      - `tag` string, required
      - `digest` string, required
      - `image_id` string, required
    - `github` ResolvedGithubUrl
      - `host` string
      - `org` string, required
      - `repo` string, required
      - `version` string, required
      - `version_type` 'head' | 'tag', required
      - `commit_hash` string, required
      - `path` string, nullable
  - `registry` union
    - string
    - string, uri
    - string, uri
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `created_by` string, uuid, required
  - `last_active_at` string, date-time
  - `agent_card` AgentCardOutput, required — 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
  - `state` union, required
    - 'missing' | 'starting' | 'ready' | 'running' | 'error'
    - 'online' | 'offline'
  - `last_error` ProviderErrorMessage
    - `message` string, required
  - `missing_configuration` EnvVar[]
    - `name` string, required
    - `description` string, nullable
    - `required` boolean
  - `type` 'managed' | 'unmanaged', required
  - `managed` boolean, required
  - `env` EnvVar[], required
    - `name` string, required
    - `description` string, nullable
    - `required` boolean

## 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)