Delete an appointment

Delete an appointment using its CRM event ID.

DELETE/custom/appointment/{id}

Authentication

x-api-key: YOUR_API_KEY

Base URL: https://api.apirilla.com

Path parameters

idstringrequired

The original event_id from your CRM. URL-encode the value when constructing the path.

Responses

200Success · text/plain.

403Missing or invalid API key.

400Invalid request parameters.

404Record not found or outside your key’s scope.

409The appointment has a linked recording and cannot be deleted.

Error reference

Common problems

400 · Invalid request

No request body is needed. URL-encode the original CRM event_id in the path; do not send the internal Rilla appointment ID.

403 · Forbidden

Use x-api-key: YOUR_API_KEY at api.apirilla.com. Do not use the Data Export host or Authorization header.

422 · Linked user or record not found

Read the response text. Check that the user, appointment and conversation belong to your key's organization. Keep the full attendee list on every appointment update.

409 · Appointment has a recording

The appointment cannot be deleted while linked to a recording. Repeating the same delete request does not fix the conflict.

Request example

curl --request DELETE \
  --url 'https://api.apirilla.com/custom/appointment/appt-1234' \
  --header 'x-api-key: YOUR_API_KEY'

Example response · text/plain

Successfully deleted event

← Create or update an appointment Match a conversation