inbox

Organize a conversation: archive, unarchive, label (e.g. 'Hot Lead'), snooze (max 200/day). snooze requires snooze_until

post/api/v1/inbox/conversations/{chat_id}/organize

Request

  • Base URL: https://crispy.sh
  • URL: https://crispy.sh/api/v1/inbox/conversations/{chat_id}/organize
  • Auth: HTTP bearer

Path parameters

chat_idstring required

Path parameter: chat_id

Request body

action'archive' | 'unarchive' | 'label' | 'unlabel' | 'snooze' | 'smart_archive' required

What to do: archive | unarchive | label | unlabel | snooze | smart_archive

labelstring

Label text for label/unlabel actions (e.g. 'Hot Lead', 'Client'). Required for label and unlabel actions.

snooze_untilstring

ISO 8601 datetime when to resurface (e.g. '2026-04-16T09:00:00Z'). Required for snooze action. Must be in the future.

notestring

Optional note for snooze action (e.g. 'Follow up on proposal'). Not sent — just for your reference.

return_on_replyboolean

For smart_archive: if true (default), conversation auto-returns when other person replies.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.