# Conversations

> Botyard REST API endpoints for conversations.

Canonical URL: https://docs.botyard.io/docs/api/conversations

26 endpoints in this group. Every request authenticates with an
[API key](/docs/api/authentication); see the [API reference](/docs/api) for the other groups.

* [Create Conversation](/docs/api/conversations/create_conversation_v1_orgs__org_id__conversations_post): `POST /v1/orgs/{org_id}/conversations`
* [Search Conversations](/docs/api/conversations/search_conversations_v1_orgs__org_id__conversations_search_post): `POST /v1/orgs/{org_id}/conversations/search`
* [List currently streaming conversations visible to the caller](/docs/api/conversations/list_active_turns_v1_orgs__org_id__conversations_active_turns_post): `POST /v1/orgs/{org_id}/conversations/active-turns`
* [Get unread counts per conversation for given bots](/docs/api/conversations/get_unread_summary_v1_orgs__org_id__conversations_unread_summary_post): `POST /v1/orgs/{org_id}/conversations/unread-summary`
* [Mark Conversation Read](/docs/api/conversations/mark_conversation_read_v1_orgs__org_id__conversations__conversation_id__read_put): `PUT /v1/orgs/{org_id}/conversations/{conversation_id}/read`
* [Reorder Pinned Conversation](/docs/api/conversations/reorder_pinned_conversation_v1_orgs__org_id__conversations__conversation_id__pin_patch): `PATCH /v1/orgs/{org_id}/conversations/{conversation_id}/pin`
* [Unpin Conversation](/docs/api/conversations/unpin_conversation_v1_orgs__org_id__conversations__conversation_id__pin_delete): `DELETE /v1/orgs/{org_id}/conversations/{conversation_id}/pin`
* [Pin Conversation](/docs/api/conversations/pin_conversation_v1_orgs__org_id__conversations__conversation_id__pin_put): `PUT /v1/orgs/{org_id}/conversations/{conversation_id}/pin`
* [Get Conversation](/docs/api/conversations/get_conversation_v1_orgs__org_id__conversations__conversation_id__get): `GET /v1/orgs/{org_id}/conversations/{conversation_id}`
* [Update Conversation](/docs/api/conversations/update_conversation_v1_orgs__org_id__conversations__conversation_id__patch): `PATCH /v1/orgs/{org_id}/conversations/{conversation_id}`
* [Delete Conversation](/docs/api/conversations/delete_conversation_v1_orgs__org_id__conversations__conversation_id__delete): `DELETE /v1/orgs/{org_id}/conversations/{conversation_id}`
* [List Conversation Process Watches](/docs/api/conversations/list_conversation_process_watches_v1_orgs__org_id__conversations__conversation_id__process_watches_get): `GET /v1/orgs/{org_id}/conversations/{conversation_id}/process-watches`
* [Get Conversation Process Watch Logs](/docs/api/conversations/get_conversation_process_watch_logs_v1_orgs__org_id__conversations__conversation_id__process_watches__watch_id__logs_get): `GET /v1/orgs/{org_id}/conversations/{conversation_id}/process-watches/{watch_id}/logs`
* [Cancel Conversation Process Watch](/docs/api/conversations/cancel_conversation_process_watch_v1_orgs__org_id__conversations__conversation_id__process_watches__watch_id__delete): `DELETE /v1/orgs/{org_id}/conversations/{conversation_id}/process-watches/{watch_id}`
* [List Conversation Timed Wakes](/docs/api/conversations/list_conversation_timed_wakes_v1_orgs__org_id__conversations__conversation_id__timed_wakes_get): `GET /v1/orgs/{org_id}/conversations/{conversation_id}/timed-wakes`
* [Cancel Conversation Timed Wake](/docs/api/conversations/cancel_conversation_timed_wake_v1_orgs__org_id__conversations__conversation_id__timed_wakes__awake_id__delete): `DELETE /v1/orgs/{org_id}/conversations/{conversation_id}/timed-wakes/{awake_id}`
* [Update Conversation Scope](/docs/api/conversations/update_conversation_scope_v1_orgs__org_id__conversations__conversation_id__scope_patch): `PATCH /v1/orgs/{org_id}/conversations/{conversation_id}/scope`
* [Fork Conversation Route](/docs/api/conversations/fork_conversation_route_v1_orgs__org_id__conversations__conversation_id__fork_post): `POST /v1/orgs/{org_id}/conversations/{conversation_id}/fork`
* [List Messages](/docs/api/conversations/list_messages_v1_orgs__org_id__conversations__conversation_id__messages_get): `GET /v1/orgs/{org_id}/conversations/{conversation_id}/messages`
* [Add Message](/docs/api/conversations/add_message_v1_orgs__org_id__conversations__conversation_id__messages_post): `POST /v1/orgs/{org_id}/conversations/{conversation_id}/messages`
* [Mutate Transcript](/docs/api/conversations/mutate_transcript_v1_orgs__org_id__conversations__conversation_id__transcript_mutations_post): `POST /v1/orgs/{org_id}/conversations/{conversation_id}/transcript-mutations`
* [List Messages After Cursor](/docs/api/conversations/list_messages_after_cursor_v1_orgs__org_id__conversations__conversation_id__messages_after_get): `GET /v1/orgs/{org_id}/conversations/{conversation_id}/messages/after`
* [Get Message](/docs/api/conversations/get_message_v1_orgs__org_id__conversations__conversation_id__messages__message_id__get): `GET /v1/orgs/{org_id}/conversations/{conversation_id}/messages/{message_id}`
* [List Pending Inputs](/docs/api/conversations/list_pending_inputs_v1_orgs__org_id__pending_inputs_get): `GET /v1/orgs/{org_id}/pending-inputs`
* [Dismiss Pending Inputs Route](/docs/api/conversations/dismiss_pending_inputs_route_v1_orgs__org_id__pending_inputs_dismissals_post): `POST /v1/orgs/{org_id}/pending-inputs/dismissals`
* [Restore Pending Inputs Route](/docs/api/conversations/restore_pending_inputs_route_v1_orgs__org_id__pending_inputs_dismissals_delete): `DELETE /v1/orgs/{org_id}/pending-inputs/dismissals`