Delete session

DELETE 
/v1/sessions/:session_id

Deletes one of the calling end user's sessions; it no longer appears in lists or reads. A voice session cannot be deleted while its call is still connected. If cleaning up the session's stored data fails, nothing is deleted (503); retry the request.

Request

Responses

204

Successful Response

401

Authentication failed: the credential is missing, malformed, expired, or revoked.

• invalid_token — The access token is invalid.
• project_disabled — This project is not active.
• token_expired — The access token has expired.
• user_disabled — This user is not active.

404

The requested resource does not exist, or is not visible to the caller.

• session_not_found — Session not found

409

The request conflicts with the current state of the resource.

• call_in_progress — A live call is using this session; end the call before deleting it.

422

A request value failed validation; the details array names each offending field.

• validation_failed — The request payload failed validation.

429

Either too many requests (a Retry-After header says when to retry) or the billing account is out of credits (no Retry-After — top up to continue); the code field tells the two apart.

• rate_limited — Too many requests. Please slow down.

500

An unexpected server-side error occurred.

• internal — An unexpected error occurred.

503

The service is temporarily unavailable; retry after a short delay.

• service_unavailable — The service is temporarily unavailable. Please retry shortly.