agent_plans

Search agent plans

Cross-thread view of what the AI SDR intends to do: filter state eq proposed for everything waiting on approval, active for what is running, or conversation_sid for one thread's plan history; page_size 0 returns counts alone. A skipped or failed step says why in its cause; a pending step whose message cannot leave yet says what it waits for. One lead is better read on its thread (get_conversation carries the active plan); why a plan looks the way it does is a run fact: search_agent_runs.

Contract:

  • MCP tool search_agent_plans, registry package mcp.unibox/agent_plans, mount unibox.agent.
  • Operation search, response envelope search.
  • Flags: read only.
post/api/agent-plans/search

Request

  • Base URL
    https://beta.getsales.io/unibox/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Request body

page_sizeinteger

0..500, default 50; 0 = counts only, 1 = the first row.

cursorstring nullable

pagination.next_cursor of the previous page.

Response

search success envelope.

successtrue required
operation'search' required
applied_filtersobject required
includesstring[] required

Changes

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