Answer an invitation

POST
/v1/conversations/{id}/invite-response

Accepts, declines or says maybe to a meeting invitation that arrived by email. The answer leaves from the mailbox the invitation reached, in the same thread, and follows that mailbox's rules: who it may write to, and any approval step. The invitation is on the message as invite.

Requires an API key with the calendar:use scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The conversation id.

Header Parameters

idempotency-key?string

A unique value (a UUID works) that makes a retry safe: sending the same key again returns the first result instead of acting twice. 1–255 printable characters.

Length1 <= length <= 255

Request Body

application/json
  1. body
messageId*string

The id of the message that shows the invitation.

Formatuuid
response*string

accept, decline, or tentative for maybe.

Value in"accept""decline""tentative"
note?string

An optional line to the organizer, sent in the same email.

Length1 <= length <= 2000

Response Body

Accepted: the answer is on its way, or waits for approval

application/json
  1. response
message*
summary*string
Example Request
curl -X POST "https://api.vlayers.ai/v1/conversations/$CONVERSATION_ID/invite-response" \  -H "Authorization: Bearer $VOICELAYER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "messageId": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32",    "response": "accept"  }'
Example Response
{  "message": {    "id": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32",    "conversationId": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21",    "channel": "sms",    "direction": "outbound",    "status": "queued",    "text": "Accepted: Demo call",    "media": [],    "from": "+14155550100",    "to": "+15550123",    "bindingId": null,    "metadata": {},    "error": null,    "untrusted": false,    "createdAt": "2026-10-20T15:04:05.000Z",    "parts": [      {        "id": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32",        "status": "queued"      }    ]  },  "summary": "Accepted \"Demo call\": your answer is on its way to [email protected]."}