{
  "opencollection": "1.0.0",
  "info": {
    "name": "API Reference agent-webhooks agents API",
    "version": "1.0.0"
  },
  "items": [
    {
      "info": {
        "name": "agents",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List Voices",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.agentphone.ai/v1/agents/voices",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              }
            ]
          },
          "docs": "Return available voices from the configured voice provider."
        },
        {
          "info": {
            "name": "List Agents",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.agentphone.ai/v1/agents",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              },
              {
                "name": "X-Sub-Account-Id",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "offset",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "List all agents for this account."
        },
        {
          "info": {
            "name": "Create Agent",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.agentphone.ai/v1/agents",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              },
              {
                "name": "X-Sub-Account-Id",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a new agent.\n\nAn agent represents an AI persona (Support Bot, Sales Agent, etc.)\nthat can have phone numbers attached to it.\n\nvoiceMode: \"webhook\" (default) forwards transcripts to your webhook.\n           \"hosted\" uses a built-in LLM with systemPrompt (no webhook needed)."
        },
        {
          "info": {
            "name": "Get Agent",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.agentphone.ai/v1/agents/:agent_id",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              },
              {
                "name": "X-Sub-Account-Id",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "agent_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Get a single agent with its attached numbers."
        },
        {
          "info": {
            "name": "Update Agent",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://api.agentphone.ai/v1/agents/:agent_id",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              },
              {
                "name": "X-Sub-Account-Id",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "agent_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update an agent's configuration.\n\nUse this to change voice mode, system prompt, greeting, or voice.\nSwitching voiceMode to \"hosted\" re-provisions the voice agent with built-in LLM."
        },
        {
          "info": {
            "name": "Delete Agent",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.agentphone.ai/v1/agents/:agent_id",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              },
              {
                "name": "X-Sub-Account-Id",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "agent_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Delete an agent.\n\nPhone numbers, conversations, and calls associated with the agent will have their\nagent reference cleared (set to null) but will not be deleted themselves."
        },
        {
          "info": {
            "name": "Attach Number To Agent",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.agentphone.ai/v1/agents/:agent_id/numbers",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "agent_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Attach an existing phone number to an agent.\n\nThe number must belong to the same account and not be released."
        },
        {
          "info": {
            "name": "Detach Number From Agent",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.agentphone.ai/v1/agents/:agent_id/numbers/:number_id",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "agent_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "number_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Detach a phone number from an agent (sets agentId to null).\n\nThe number remains active and can be re-attached to any agent."
        },
        {
          "info": {
            "name": "List Agent Conversations",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.agentphone.ai/v1/agents/:agent_id/conversations",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "agent_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query"
              },
              {
                "name": "offset",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "List all conversations for an agent."
        },
        {
          "info": {
            "name": "List Agent Calls",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.agentphone.ai/v1/agents/:agent_id/calls",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "agent_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query"
              },
              {
                "name": "offset",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "List all calls for an agent."
        }
      ]
    }
  ],
  "bundled": true
}