Update Conversation | AgentPhone

Update conversation metadata (state).

Use this to store custom context for AI agents:

Customer information (name, account ID)
Business context (order ID, ticket number)
Session state (current topic, preferences)

The metadata is included in webhook payloads as conversationState.

Update conversation metadata (state). Use this to store custom context for AI agents: - Customer information (name, account ID) - Business context (order ID, ticket number) - Session state (current topic, preferences) The metadata is included in webhook payloads as `conversationState`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

conversation_idstringRequired

Request

This endpoint expects an object.

metadataobject or nullOptional

Response

Successful Response

idstring

phoneNumberIdstring

phoneNumberstring

participantstring

lastMessageAtdatetime

messageCountinteger

createdAtdatetime

messageslist of objects

agentIdstring or null

metadataobject or null

1	import { AgentPhoneClient } from "agentphone";
2
3	async function main() {
4	const client = new AgentPhoneClient({
5	token: "YOUR_TOKEN_HERE",
6	});
7	await client.conversations.updateConversation("conversation_id", {});
8	}
9	main();

1	{
2	"id": "string",
3	"phoneNumberId": "string",
4	"phoneNumber": "string",
5	"participant": "string",
6	"lastMessageAt": "2024-01-15T09:30:00Z",
7	"messageCount": 1,
8	"createdAt": "2024-01-15T09:30:00Z",
9	"messages": [
10	{
11	"id": "string",
12	"body": "string",
13	"fromNumber": "string",
14	"toNumber": "string",
15	"direction": "string",
16	"receivedAt": "2024-01-15T09:30:00Z"
17	}
18	],
19	"agentId": "string",
20	"metadata": {}
21	}

Authentication

Path parameters

Request

Response

Errors