Skip to main content
PATCH
/
agents
/
{agent_id}
cURL
curl -X PATCH 'https://api.gumloop.com/api/v1/agents/abc123DEFghiJKL' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "description": "Researches enterprise accounts and drafts outreach",
    "is_active": true
  }'
{
  "agent": {
    "id": "abc123DEFghiJKL",
    "name": "Sales research agent",
    "description": "Researches enterprise accounts and drafts outreach",
    "team_id": "team_4f8c92ab",
    "is_active": true,
    "tools": [],
    "metadata": {},
    "model_name": "anthropic/claude-sonnet-4",
    "system_prompt": "You are a B2B sales research assistant.",
    "resources": [],
    "folder_id": "folder_91ab",
    "type": null,
    "created_at": "2026-05-15T14:32:00Z",
    "active_trigger_count": null,
    "creator": {
      "id": "user_8c2a1b",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "email": "ada@example.com",
      "profile_picture": null
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Path Parameters

​
agent_id
string
required

ID of the agent to update.

Body

application/json
​
name
string | null
​
model_name
string | null

ID of the LLM the agent runs on. Use GET /models to discover valid values.

Example:

"anthropic/claude-sonnet-4"

​
description
string | null
Example:

"Researches enterprise accounts and drafts outreach"

​
system_prompt
string | null
​
tools
object[] | null

When provided, replaces the agent's tool list.

​
resources
object[] | null

When provided, replaces the agent's resource list.

​
metadata
object
​
is_active
boolean | null
​
team_id
string | null

When provided, transfers ownership of the agent to this team.

Response

The updated agent.

​
agent
object