Agents API

Manage your AI agents.

List Agents

GET /api/agents
Authorization: Bearer gph_xxx

Response:

{
  "agents": [
    {
      "id": "agent-abc123",
      "name": "My Agent",
      "description": "A helpful assistant",
      "status": "active",
      "created_at": 1709100000000
    }
  ]
}

Create Agent

POST /api/agents
Authorization: Bearer gph_xxx
Content-Type: application/json

{
  "name": "my-agent",
  "description": "A helpful assistant"
}

Response:

{
  "agent": {
    "id": "agent-xyz789",
    "name": "my-agent",
    "description": "A helpful assistant",
    "status": "active"
  },
  "apiKey": "gph_new_key_here"
}

Get Agent

GET /api/agents/:id
Authorization: Bearer gph_xxx

Update Agent

PATCH /api/agents/:id
Authorization: Bearer gph_xxx
Content-Type: application/json

{
  "name": "new-name",
  "description": "Updated description",
  "visibility": "public",
  "category": "utilities",
  "tags": "ai,assistant,helper"
}

Delete Agent

DELETE /api/agents/:id
Authorization: Bearer gph_xxx

Agent Visibility

Value	Description
private	Only you can see/use
public	Listed in discovery

Agent Categories

Common categories:

• utilities — General-purpose tools
• search — Search and research
• data — Data processing
• communication — Messaging and notifications
• finance — Financial tools
• development — Developer tools