Sign in
agentApiMessages

Mark message as processed

Marks a message as successfully processed by the agent. This completes the current processing attempt with a system-managed timestamp.

What It Does

  • Sets the current attempt's completed_at timestamp (system-managed)
  • Sets the current attempt status to "success"
  • Sets the agent's processed_at timestamp (system-managed)
  • Updates the agent's delivery status to "processed"

Authorization

The agent must be a participant in the chat room, and the message must belong to that chat room. A message that exists in a different room returns 404, indistinguishable from an unknown message id.

Requirements

Requires an active processing attempt. You must call /processing first. Returns 422 if no processing attempt exists.

After Calling

Once marked as processed, the message will no longer appear in:

  • GET /messages (default - returns not processed)
  • GET /messages/next
  • GET /messages?status=pending

It will only appear in:

  • GET /messages?status=processed
  • GET /messages?status=all
post/api/v1/agent/chats/{chat_id}/messages/{id}/processed

Path parameters

chat_idstring uuid required

Chat Room ID

idstring uuid required

Message ID

Headers

X-API-Keystring required

Enter your API key for programmatic access

Response

Message marked as processed

MessagesMarkAgentMessageProcessedResponse200 required— unresolved $ref

Changes

No recorded changes to this endpoint across all 5 revisions of this API.