---
title: "Find literal occurrences in the active conversation branch"
method: GET
path: "/api/v1/conversations/{conversationId}/find"
tags: ["conversations"]
---

# Find literal occurrences in the active conversation branch

`GET /api/v1/conversations/{conversationId}/find`

## Request

- Base URL: `http://127.0.0.1:3001`
- URL: `http://127.0.0.1:3001/api/v1/conversations/{conversationId}/find`
- Auth: none declared
- TypeScript: <https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/docs/api/v1/conversations/:conversationId/find/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `conversationId` string, required

## Query parameters

- `query` string: Case-insensitive literal substring in displayed message text (maximum 512 characters).
- `cursor` string: Opaque continuation bound to query and transcript revision.
- `anchorMessageId` string: Start at or after this visible message when cursor is absent.
- `anchorBlock` integer
- `anchorOffset` integer
- `anchorSequence` integer: Fallback position when the anchor message was removed.
- `fallbackToPrevious` boolean: Choose the preceding match if a removed anchor has no following match.

## Response `200`

OK

- ConversationFindResponse
  - `conversationId` string, required
  - `initialIndex` integer, required
  - `lastCursor` string
  - `nextCursor` string
  - `occurrences` ConversationFindOccurrence[], required
    - `block` integer, required
    - `end` integer, required
    - `messageId` string, required
    - `revision` integer, required
    - `sequence` integer, required
    - `start` integer, required
  - `offset` integer, required
  - `previousCursor` string
  - `total` integer, required
  - `transcriptRevision` string, required

## Other responses

- `400`: Bad Request
- `409`: Conflict
- `500`: Internal Server Error
- `501`: Not Implemented

## Changes

- **2026-11-09** `a2ac57b93019`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/conversations/:conversationId/find/get.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) - [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) - [OpenAPI document](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/revisions/9a5e9e8e6a6e?raw)