How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AgentPhone agents API

The agents API from AgentPhone — 7 operation(s) for agents.

AgentPhone agents API is one of 13 APIs that AgentPhone publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 10 operations across 7 paths, and defines 36 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.agentphone.ai.

10 operations 7 paths 36 schemas 2 DELETE5 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.agentphone.ai
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

AgentPhone agents API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 10

Across 7 paths, the API surfaces 10 operations — 2 DELETE, 5 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

agents 10
GET
/v1/agents/voices
List Voices
list-voices-v-1-agents-voices-get 1 param → 200
GET
/v1/agents
List Agents
list-agents-v-1-agents-get 3 params → 200422
POST
/v1/agents
Create Agent
create-agent-v-1-agents-post 2 params body → 200422
GET
/v1/agents/{agent_id}
Get Agent
get-agent-v-1-agents-agent-id-get 3 params → 200422
DELETE
/v1/agents/{agent_id}
Delete Agent
delete-agent-v-1-agents-agent-id-delete 3 params → 200422
PATCH
/v1/agents/{agent_id}
Update Agent
update-agent-v-1-agents-agent-id-patch 3 params body → 200422
POST
/v1/agents/{agent_id}/numbers
Attach Number To Agent
attach-number-to-agent-v-1-agents-agent-id-numbers-post 2 params body → 200422
DELETE
/v1/agents/{agent_id}/numbers/{number_id}
Detach Number From Agent
detach-number-from-agent-v-1-agents-agent-id-numbers-number-id-delete 3 params → 200422
GET
/v1/agents/{agent_id}/conversations
List Agent Conversations
list-agent-conversations-v-1-agents-agent-id-conversations-get 4 params → 200422
GET
/v1/agents/{agent_id}/calls
List Agent Calls
list-agent-calls-v-1-agents-agent-id-calls-get 4 params → 200422

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are AgentResponse (24 properties), CreateAgentRequest (21 properties), UpdateAgentRequest (21 properties), CallSummary (11 properties). Each schema is shown below with its type and property counts.

AgentNumberResponse
object
4 properties 3 required
CreateAgentRequestLanguage
string
BCP-47 locale that drives the agent's speech recognition and pronunciation. Defaults to 'en-US'. See the enum for the full set of supported codes.
ValidationError
object
3 properties 3 required
UpdateAgentRequestAmbientSound
string
Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed.
UpdateAgentRequestModelTier
string
UpdateAgentRequestSttMode
string
Speech-to-text mode. 'fast' optimizes for latency, 'accurate' optimizes for transcription accuracy (~200ms additional latency).
UpdateAgentRequestLanguage
string
BCP-47 locale that drives the agent's speech recognition and pronunciation. See the enum for the full set of supported codes.
CreateAgentRequestVoiceMode
string
AgentResponseModelTier
string
CreateAgentRequestModelTier
string
UpdateAgentRequestVoiceMode
string
AgentResponseVoiceMode
string
UpdateAgentRequest
object
21 properties
CreateAgentRequestDenoisingMode
string
Audio denoising. 'noise-cancellation' (default) handles general noise. 'noise-and-background-speech-cancellation' is more aggressive for callers in cars, cafes…
CreateAgentRequestAmbientSound
string
Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed.
AgentResponseAmbientSound
string
Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed.
ValidationErrorLocItems
CustomToolParam
object
9 properties 3 required
AgentResponseSttMode
string
Speech-to-text mode. 'fast' optimizes for latency, 'accurate' optimizes for transcription accuracy (~200ms additional latency).
AgentResponse
object
24 properties 6 required
HTTPValidationError
object
1 property
CreateAgentRequest
object
21 properties 1 required
app__routes__agents__ConversationListResponse
object
3 properties 3 required
AttachNumberResponse
object
2 properties 2 required
AttachNumberRequest
object
1 property 1 required
CreateAgentRequestSttMode
string
Speech-to-text mode. 'fast' optimizes for latency, 'accurate' optimizes for transcription accuracy (~200ms additional latency).
CallSummary
object
11 properties 11 required
CustomToolParamParameters
object
JSON Schema object describing the arguments the agent fills in. Omit for a no-argument tool.
AgentListResponse
object
2 properties 2 required
DeleteAgentResponse
object
3 properties 3 required
AgentResponseCustomToolsItems
object
app__routes__agents__ConversationSummary
object
9 properties 9 required
AgentResponseDenoisingMode
string
Audio denoising. 'noise-cancellation' (default) handles general noise. 'noise-and-background-speech-cancellation' is more aggressive for callers in cars, cafes…
CallListResponse
object
3 properties 3 required
CustomToolParamMethod
string
HTTP method. Defaults to POST.
UpdateAgentRequestDenoisingMode
string
Audio denoising. 'noise-cancellation' (default) handles general noise. 'noise-and-background-speech-cancellation' is more aggressive for callers in cars, cafes…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

agentphone-agents-api-openapi.yml Raw ↑

Other APIs AgentPhone publishes across the network.

AgentPhone agent-webhooks API
AgentPhone calls API
AgentPhone contactCards API
AgentPhone contacts API
AgentPhone conversations API
AgentPhone location API
AgentPhone messages API
AgentPhone numbers API
AgentPhone registration API
AgentPhone sub-accounts API
AgentPhone usage API
AgentPhone webhooks API
Where this information came from

This is an independent, third-party profile of AgentPhone agents API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.