Chats

Mark a message as handled

Records that a property manager has dealt with a message the AI escalated. Nothing is sent to the participant.

POST

https://api.portal.magicdoor.com/company-app/chats/{chatId}/messages/{messageId}/mark-as-handled

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

chatIdstringrequired

The chat the message is in.

example: 1830472847398404096

messageIdstringrequired

The message to mark handled.

example: 1831055120837640192

Response

200 · The message was marked handled, or was already past that point. The response has no body.

401 · The access token is missing, expired, or not valid.

403 · The message exists but belongs to a different chat than the one in the URL.

404 · No message with that id belongs to your company.

Only a message whose aiProcessingStatus is manual — the AI handed it to a person — is changed. Calling this on any other message succeeds and does nothing.

Request

curl --request POST \
  --url 'https://api.portal.magicdoor.com/company-app/chats/1830472847398404096/messages/1831055120837640192/mark-as-handled' \
  --header 'Authorization: Bearer <token>'

Response

{
  "type": "https://httpstatuses.com/404",
  "title": "Not Found",
  "status": 404,
  "detail": "ChatMessage 1831055120837640192 was not found",
  "traceId": "0HN7GK9C2M4PQ"
}