Answer an invitation
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.
apiKeyAuthorizationBearer <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.
id*stringThe conversation id.
idempotency-key?stringA 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.
1 <= length <= 255application/json- body
messageId*stringThe id of the message that shows the invitation.
uuidresponse*stringaccept, decline, or tentative for maybe.
"accept""decline""tentative"note?stringAn optional line to the organizer, sent in the same email.
1 <= length <= 2000Accepted: the answer is on its way, or waits for approval
application/json- response
message*summary*stringcurl -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" }'{ "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]."}