Properties
| Name | Type | Description |
|---|---|---|
| phoneNumber | object | This is the phone number that the message is associated with. |
| type | string | This is the type of the message. "conversation-update" is sent when an update is committed to the conversation history. |
| messages | array | This is the most up-to-date conversation history at the time the message is sent. |
| messagesOpenAIFormatted | array | This is the most up-to-date conversation history at the time the message is sent, formatted for OpenAI. |
| timestamp | number | This is the timestamp of the message. |
| artifact | object | This is a live version of the `call.artifact`. This matches what is stored on `call.artifact` after the call. |
| assistant | object | This is the assistant that the message is associated with. |
| customer | object | This is the customer that the message is associated with. |
| call | object | This is the call that the message is associated with. |
| chat | object | This is the chat object. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/ServerMessageConversationUpdate",
"title": "ServerMessageConversationUpdate",
"type": "object",
"properties": {
"phoneNumber": {
"description": "This is the phone number that the message is associated with.",
"oneOf": [
{
"$ref": "#/components/schemas/CreateByoPhoneNumberDTO",
"title": "ByoPhoneNumber"
},
{
"$ref": "#/components/schemas/CreateTwilioPhoneNumberDTO",
"title": "TwilioPhoneNumber"
},
{
"$ref": "#/components/schemas/CreateVonagePhoneNumberDTO",
"title": "VonagePhoneNumber"
},
{
"$ref": "#/components/schemas/CreateVapiPhoneNumberDTO",
"title": "VapiPhoneNumber"
},
{
"$ref": "#/components/schemas/CreateTelnyxPhoneNumberDTO",
"title": "TelnyxPhoneNumber"
}
]
},
"type": {
"type": "string",
"description": "This is the type of the message. \"conversation-update\" is sent when an update is committed to the conversation history.",
"enum": [
"conversation-update"
]
},
"messages": {
"type": "array",
"description": "This is the most up-to-date conversation history at the time the message is sent.",
"items": {
"oneOf": [
{
"$ref": "#/components/schemas/UserMessage",
"title": "UserMessage"
},
{
"$ref": "#/components/schemas/SystemMessage",
"title": "SystemMessage"
},
{
"$ref": "#/components/schemas/BotMessage",
"title": "BotMessage"
},
{
"$ref": "#/components/schemas/ToolCallMessage",
"title": "ToolCallMessage"
},
{
"$ref": "#/components/schemas/ToolCallResultMessage",
"title": "ToolCallResultMessage"
}
]
}
},
"messagesOpenAIFormatted": {
"description": "This is the most up-to-date conversation history at the time the message is sent, formatted for OpenAI.",
"type": "array",
"items": {
"$ref": "#/components/schemas/OpenAIMessage"
}
},
"timestamp": {
"type": "number",
"description": "This is the timestamp of the message."
},
"artifact": {
"description": "This is a live version of the `call.artifact`.\n\nThis matches what is stored on `call.artifact` after the call.",
"allOf": [
{
"$ref": "#/components/schemas/Artifact"
}
]
},
"assistant": {
"description": "This is the assistant that the message is associated with.",
"allOf": [
{
"$ref": "#/components/schemas/CreateAssistantDTO"
}
]
},
"customer": {
"description": "This is the customer that the message is associated with.",
"allOf": [
{
"$ref": "#/components/schemas/CreateCustomerDTO"
}
]
},
"call": {
"description": "This is the call that the message is associated with.",
"allOf": [
{
"$ref": "#/components/schemas/Call"
}
]
},
"chat": {
"description": "This is the chat object.",
"allOf": [
{
"$ref": "#/components/schemas/Chat"
}
]
}
},
"required": [
"type",
"messagesOpenAIFormatted"
]
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/vapi-servermessageconversationupdate"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.