Delete Chat Conversation by ID

delete

https://{hostname}/api/talk/chat/v1/conversations/{conversationId}

This operation deletes a chat conversation by ID.

Design Note

Conversations are implicitly created when messages are sent via the Chat Messages operation (POST /chat/v1/messages). The Chat Conversations API resource provides only GET and DELETE operations. There are no POST or PATCH operations for conversations as they are managed automatically through message creation.

Authorization and Permissions

An OpenAm or UKG Authentication token is required to delete a conversation.

Responses

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Choose an example:

*/*

application/problem+json

204Successfully deleted the conversation.

401The HTTP status code 401 Unauthorized error, thrown when the user is not authorized to access the resource.

403The HTTP status code 403 Forbidden error, thrown when the user is not authorized to access the resource.

404The HTTP status code 404 Not Found error, thrown when the post is not found.

405The HTTP status code 405 Method Not Allowed error, thrown when you attempt to call a URI with an unsupported HTTP method.

406The HTTP status code 406 Not Acceptable Content error, thrown when you send a request with accept header other than application/json.

413The HTTP status code 413 Payload Too Large error, thrown when you attempt to pass a request payload that exceeds the limit.

429The HTTP status code 429 Too Many Requests error, thrown when the user exceeds the allowed rate limit for the API.

500The HTTP status code 500 Internal Server error, thrown when the server is not able to process the request.