Attach an inbound source to an agent

POST

https://api.smallest.ai/atoms/v1/agent/:agentId/answers

Makes the agent answer calls arriving on a rented number or inbound SIP trunk you own. Requires an admin-role key. A source is answered by exactly one agent: if another agent already answers it, 409 identifies that agent by id (“Already answered by another agent (…). Detach it there first.”). This replaces the legacy telephonyProductId field on agent writes.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

agentIdstringRequired

Request

This endpoint expects an object.

sourceKindenumRequired

Allowed values:

sourceIdstringRequired

The phone number product ID, or the inbound SIP trunk ID.

Response

Binding created. Returns the stored binding record (not the read shape GET .../answers uses).

statusbooleanOptional

dataobjectOptional

The stored binding record, as returned by the attach endpoints.

Errors

404

Not Found Error

409

Conflict Error

1	import requests
2
3	url = "https://api.smallest.ai/atoms/v1/agent/agentId/answers"
4
5	payload = {
6	"sourceKind": "phoneNumber",
7	"sourceId": "60d0fe4f5311236168a109ca"
8	}
9	headers = {
10	"Authorization": "Bearer <token>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())

1	{
2	"status": true,
3	"data": {
4	"_id": "string",
5	"agentId": "string",
6	"sourceKind": "phoneNumber",
7	"sourceId": "string",
8	"number": "string",
9	"createdAt": "2024-01-15T09:30:00Z",
10	"updatedAt": "2024-01-15T09:30:00Z"
11	}
12	}