chat

One conversation with its messages and runs

One conversation: its newest messages in order (a page of limit; earlier_cursor pages back through older ones), and the runs those messages hold (started by the chat, or attached with conversation_id in the same stretch of time) with their hooks. Free. MCP: get_conversation.

get/v1/conversations/{conversation_id}

Request

  • Base URL: https://api.hookdetector.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.hookdetector.com/v1/conversations/{conversation_id}
  • Auth: none declared

Path parameters

conversation_idstring uuid required

Query parameters

limitinteger

messages per page, newest page first

beforestring nullable

earlier_cursor from the previous page; leave out for the newest messages

Headers

authorizationstring nullable

Bearer hd_... from POST /v1/accounts or POST /v1/keys

Response

Successful Response

conversation_idstring required
titlestring required
languagestring nullable
countrystring nullable
posted_within_daysinteger nullable

the conversation's recency chip, or null for any time

created_atstring required
updated_atstring required
earlier_cursorstring nullable

pass as before for the page of older messages; null when this page reaches the first message

Example response

{
  "conversation_id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
  "created_at": "2026-09-23T10:00:00.000000+00:00",
  "messages": [
    {
      "content": "cold plunge hooks",
      "created_at": "2026-09-23T10:00:00.000000+00:00",
      "role": "user"
    }
  ],
  "runs": [],
  "title": "cold plunge",
  "updated_at": "2026-09-23T10:00:00.000000+00:00"
}

Changes

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