Skip to main content
POST
/
agents
cURL
curl -X POST 'https://api.gumloop.com/api/v1/agents' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Sales research agent",
    "model_name": "anthropic/claude-sonnet-4",
    "description": "Researches accounts and drafts outreach",
    "system_prompt": "You are a B2B sales research assistant.",
    "team_id": "team_4f8c92ab"
  }'
{
  "agent": {
    "id": "abc123DEFghiJKL",
    "name": "Sales research agent",
    "description": "Researches 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.

Body

application/json
​
name
string
required

Display name for the agent.

Example:

"Sales research agent"

​
model_name
string
required

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 accounts and drafts outreach"

​
system_prompt
string | null
Example:

"You are a B2B sales research assistant."

​
tools
object[]

Tools the agent can call. Each tool is an object whose shape depends on the tool type.

​
resources
object[]

Resources attached to the agent.

​
metadata
object

Arbitrary key/value metadata stored on the agent.

​
folder_id
string | null

ID of the folder to place the agent in.

Example:

"folder_91ab"

​
is_active
boolean
default:true

Whether the agent is active. Defaults to true.

​
agent_id
string | null

Optional caller-supplied agent ID. When omitted, the server generates one.

​
team_id
string | null

ID of the team to create the agent under. When omitted, the agent is owned by the authenticated user.

Example:

"team_4f8c92ab"

Response

Agent created.

​
agent
object