Skip to main content
PATCH
/
v1
/
agents
/
{id}
Update Agent
curl --request PATCH \
  --url https://api.agent-drop.com/v1/agents/{id} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "webhook_url": "<string>",
  "agent_type": "<string>",
  "metadata": {}
}
'
{
  "id": "<string>",
  "agent_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "webhook_url": "<string>",
  "agent_type": "<string>",
  "connection_status": "<string>",
  "metadata": {},
  "created_at": "<string>"
}
Update one or more fields on an existing agent. Only the fields you include in the request body will be changed.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx
​
Content-Type
string
required
Must be application/json

​
Path Parameters

​
id
string
required
The agent’s UUID. Example: 550e8400-e29b-41d4-a716-446655440000

​
Body Parameters

​
name
string
Human-readable name for the agent.
​
description
string
Description of what this agent does.
​
webhook_url
string
Reserved for a future release. Webhooks are not yet available on standard plans.
​
agent_type
string
Framework type. One of: custom, langchain, crewai, autogen, mastra, n8n.
​
metadata
object
Custom metadata object. Replaces existing metadata entirely.

​
Response

Returns the full updated agent object.
​
id
string
Internal UUID for this agent record.
​
agent_id
string
The unique slug identifier.
​
name
string
Updated name.
​
description
string
Updated description.
​
webhook_url
string
Reserved field. Currently unused on standard plans.
​
agent_type
string
Updated framework type.
​
connection_status
string
Current connection status.
​
metadata
object
Updated metadata.
​
created_at
string
ISO 8601 creation timestamp.

​
Examples

curl -X PATCH https://api.agent-drop.com/v1/agents/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Data Pipeline v2",
    "description": "Upgraded pipeline with streaming support",
    "metadata": { "env": "production", "version": "2.0" }
  }'

​
Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": "data-pipeline",
  "name": "Data Pipeline v2",
  "description": "Upgraded pipeline with streaming support",
  "webhook_url": "https://example.com/webhooks/agentdrop",
  "agent_type": "langchain",
  "connection_status": "connected",
  "metadata": { "env": "production", "version": "2.0" },
  "created_at": "2026-03-15T09:00:00Z"
}

​
Errors

StatusCodeDescription
400VALIDATION_ERRORInvalid field values (e.g. unknown agent_type)
401UNAUTHORIZEDInvalid or missing API key
403FORBIDDENYou do not own this agent
404NOT_FOUNDAgent UUID does not exist