Search
K
Agent Deployments

List agent deployments

get

Query Parameters

statusstring

Allowed values:draftactivepauseddeprecatedretiredarchived

Example:active

categorystring

Allowed values:copilotautonomous-agentworkflow-agentrag-assistantvoice-agent

Example:copilot

business_unitstring

Filter by owning business unit.

Example:Platform Engineering

limitinteger

Default:25

>= 1<= 100

cursorstring

Response

application/json

Results list

dataarray
Show Child Parameters
pageobject

Cursor-based pagination.

Show Child Parameters
get/agents
 
application/json

Register an agent deployment

post

Body

application/json

AgentInput

categorystringrequired

Allowed values:copilotautonomous-agentworkflow-agentrag-assistantvoice-agent

Example:copilot

deployment_tierstring

Allowed values:sandboxpilotproduction

Example:pilot

titlestringrequired

<= 120 characters

Example:Internal Support Triage Copilot

descriptionstring

Example:Triages inbound support tickets and drafts first-response replies for human review.

owning_teamobjectrequired
Show Child Parameters
integration_countinteger

Example:6

tool_countinteger

Example:4

model_providerstring

Example:Anthropic Claude

model_release_datestring(date)

Example:2026-02-01

cost_per_1k_tokens_usdnumber(float)

Example:0.015

monthly_budget_usdinteger

Example:4000

support_budget_usdinteger

Example:500

available_fromstring(date)

Example:2026-11-01

compliance_certificationobject

Figures needed to publish a catalog entry.

Show Child Parameters
chargebackobject
Show Child Parameters

Response

application/json

Registered

Agent

categorystringrequired

Allowed values:copilotautonomous-agentworkflow-agentrag-assistantvoice-agent

Example:copilot

deployment_tierstring

Allowed values:sandboxpilotproduction

Example:pilot

titlestringrequired

<= 120 characters

Example:Internal Support Triage Copilot

descriptionstring

Example:Triages inbound support tickets and drafts first-response replies for human review.

owning_teamobjectrequired
Show Child Parameters
integration_countinteger

Example:6

tool_countinteger

Example:4

model_providerstring

Example:Anthropic Claude

model_release_datestring(date)

Example:2026-02-01

cost_per_1k_tokens_usdnumber(float)

Example:0.015

monthly_budget_usdinteger

Example:4000

support_budget_usdinteger

Example:500

available_fromstring(date)

Example:2026-11-01

compliance_certificationobject

Figures needed to publish a catalog entry.

Show Child Parameters
chargebackobject
Show Child Parameters
idstring

Example:agt_8f2c1a

statusstring

Allowed values:draftactivepauseddeprecatedretiredarchived

Example:active

artifact_countinteger

Example:14

created_atstring(date-time)

Example:2026-08-14T08:12:44Z

updated_atstring(date-time)

Example:2026-08-20T09:38:02Z

post/agents

Body

{ "category": "copilot", "deployment_tier": "pilot", "title": "Internal Support Triage Copilot", "owning_team": { "owning_team": "Support Engineering", "business_unit": "Customer Success", "cost_center": "CC-4021" }, "integration_count": 6, "tool_count": 4, "model_provider": "Anthropic Claude", "model_release_date": "2026-02-01", "cost_per_1k_tokens_usd": 0.015, "chargeback": { "rate_percent": 12, "note": "includes shared platform overhead" } }
 
application/json

Retrieve an agent deployment

get

Path Parameters

agentIdstringrequired

Example:agt_8f2c1a

Response

application/json

Agent deployment

Agent

categorystringrequired

Allowed values:copilotautonomous-agentworkflow-agentrag-assistantvoice-agent

Example:copilot

deployment_tierstring

Allowed values:sandboxpilotproduction

Example:pilot

titlestringrequired

<= 120 characters

Example:Internal Support Triage Copilot

descriptionstring

Example:Triages inbound support tickets and drafts first-response replies for human review.

owning_teamobjectrequired
Show Child Parameters
integration_countinteger

Example:6

tool_countinteger

Example:4

model_providerstring

Example:Anthropic Claude

model_release_datestring(date)

Example:2026-02-01

cost_per_1k_tokens_usdnumber(float)

Example:0.015

monthly_budget_usdinteger

Example:4000

support_budget_usdinteger

Example:500

available_fromstring(date)

Example:2026-11-01

compliance_certificationobject

Figures needed to publish a catalog entry.

Show Child Parameters
chargebackobject
Show Child Parameters
idstring

Example:agt_8f2c1a

statusstring

Allowed values:draftactivepauseddeprecatedretiredarchived

Example:active

artifact_countinteger

Example:14

created_atstring(date-time)

Example:2026-08-14T08:12:44Z

updated_atstring(date-time)

Example:2026-08-20T09:38:02Z

get/agents/{agentId}
 
application/json

Update an agent deployment

Updates individual fields. Catalog entries already generated remain unchanged.

patch

Path Parameters

agentIdstringrequired

Example:agt_8f2c1a

Body

application/json

AgentInput

categorystringrequired

Allowed values:copilotautonomous-agentworkflow-agentrag-assistantvoice-agent

Example:copilot

deployment_tierstring

Allowed values:sandboxpilotproduction

Example:pilot

titlestringrequired

<= 120 characters

Example:Internal Support Triage Copilot

descriptionstring

Example:Triages inbound support tickets and drafts first-response replies for human review.

owning_teamobjectrequired
Show Child Parameters
integration_countinteger

Example:6

tool_countinteger

Example:4

model_providerstring

Example:Anthropic Claude

model_release_datestring(date)

Example:2026-02-01

cost_per_1k_tokens_usdnumber(float)

Example:0.015

monthly_budget_usdinteger

Example:4000

support_budget_usdinteger

Example:500

available_fromstring(date)

Example:2026-11-01

compliance_certificationobject

Figures needed to publish a catalog entry.

Show Child Parameters
chargebackobject
Show Child Parameters

Response

application/json

Updated

Agent

categorystringrequired

Allowed values:copilotautonomous-agentworkflow-agentrag-assistantvoice-agent

Example:copilot

deployment_tierstring

Allowed values:sandboxpilotproduction

Example:pilot

titlestringrequired

<= 120 characters

Example:Internal Support Triage Copilot

descriptionstring

Example:Triages inbound support tickets and drafts first-response replies for human review.

owning_teamobjectrequired
Show Child Parameters
integration_countinteger

Example:6

tool_countinteger

Example:4

model_providerstring

Example:Anthropic Claude

model_release_datestring(date)

Example:2026-02-01

cost_per_1k_tokens_usdnumber(float)

Example:0.015

monthly_budget_usdinteger

Example:4000

support_budget_usdinteger

Example:500

available_fromstring(date)

Example:2026-11-01

compliance_certificationobject

Figures needed to publish a catalog entry.

Show Child Parameters
chargebackobject
Show Child Parameters
idstring

Example:agt_8f2c1a

statusstring

Allowed values:draftactivepauseddeprecatedretiredarchived

Example:active

artifact_countinteger

Example:14

created_atstring(date-time)

Example:2026-08-14T08:12:44Z

updated_atstring(date-time)

Example:2026-08-20T09:38:02Z

patch/agents/{agentId}

Body

{ "deployment_tier": "production" }
 
application/json

Retire an agent deployment

Takes the agent out of active service. The record remains readable.

delete

Path Parameters

agentIdstringrequired

Example:agt_8f2c1a

Response

Retired

delete/agents/{agentId}