> ## Documentation Index > Fetch the complete documentation index at: https://docs.getsales.io/llms.txt > Use this file to discover all available pages before exploring further. # Get agent run > One AI SDR run, as the Analyzer's drawer opens it: include made answers how its reply was made in six steps (read, plan, gather, write, check, sent: what the turn read, decided, wrote and was checked by), beside reply, trigger, lead and scenario. A rewrite's test run reads running until it is done (its words in record.text) or failed. Contract: - MCP tool `get_agent_run`, registry package `mcp.unibox/agent_runs`, mount `unibox.agent`. - Operation `get`, response envelope `get`. - Flags: read only. ## OpenAPI ````yaml /api-reference/unibox/openapi.yaml get /api/agent-runs/{sid} openapi: 3.0.3 info: title: 'GetSales public contract: gs.service.unibox' description: >- The team inbox and the AI SDR: every LinkedIn and email thread in one place (conversations, messages, the timeline events), the manual tasks a thread spawns, the sender profiles the team speaks through with their LinkedIn account and mailboxes, and the one agent per team with its scenarios, plans and runs. GENERATED. This document is projected from the Zod MCP tool registry in `product/mcp/gs.mcp` (one tool per public endpoint, 1:1). Do not edit it by hand; edit the tool definition and regenerate with `pnpm openapi:public`. Surface: the public `/api` contract of `gs.service.unibox`, 125 operations. This is the only OpenAPI document the platform publishes. Internal (`/internal`) and health endpoints are deliberately absent: they are not part of any contract, they can change without notice, and the service source is their only description. Conventions: - Auth is a bearer JWT, optionally narrowed by the `Team-SID` header. - Every success body is an MCP envelope: `success: true` plus one typed `operation` shape (`search`, `get`, `create`, `update`, `delete`, `metrics`, `group_by`, `action`), and a `meta` block with `trace_id` for support. - Every failure is the same `McpError` envelope with a code from a fixed 16-code taxonomy, so a client maps errors once. - Lists page with `page_size` (0 to 500, default 50) plus an opaque forward `cursor`; `page_size: 0` returns counts only. - On `GET` and `DELETE`, object-valued query parameters (`filter`, `sort`) travel as JSON text and array-valued ones repeat as `name[]=value`. - The MCP-only `_meta` field (usage analytics) never reaches the backend and is not part of this contract. version: '1.0' contact: name: GetSales url: https://getsales.io email: support@getsales.io license: name: Proprietary url: https://getsales.io/terms servers: - url: https://beta.getsales.io/unibox/v1 description: >- Production (the gateway path on the beta ring; the origin is provisioned per DEPLOY_MAP.md) security: - BearerJwt: [] TeamSid: [] tags: - name: agent_answers description: >- Registry package `mcp.unibox/agent_answers`, served on MCP mount `unibox.knowledge`. - name: agent_conversation_uploads description: >- Registry package `mcp.unibox/agent_conversation_uploads`, served on MCP mount `unibox.agent-memory`. - name: agent_examples description: >- Registry package `mcp.unibox/agent_examples`, served on MCP mount `unibox.agent-memory`. - name: agent_hints description: >- Registry package `mcp.unibox/agent_hints`, served on MCP mount `unibox.agent-memory`. - name: agent_plans description: >- Registry package `mcp.unibox/agent_plans`, served on MCP mount `unibox.agent`. - name: agent_runs description: >- Registry package `mcp.unibox/agent_runs`, served on MCP mount `unibox.agent-memory`. - name: agent_scenarios description: >- Registry package `mcp.unibox/agent_scenarios`, served on MCP mount `unibox.agent`. - name: agent_source_parses description: >- Registry package `mcp.unibox/agent_source_parses`, served on MCP mount `unibox.knowledge`. - name: agent_sources description: >- Registry package `mcp.unibox/agent_sources`, served on MCP mount `unibox.knowledge`. - name: agent_tests description: >- Registry package `mcp.unibox/agent_tests`, served on MCP mount `unibox.agent-memory`. - name: agents description: >- Registry package `mcp.unibox/agents`, served on MCP mount `unibox.website`. - name: conversation_events description: >- Registry package `mcp.unibox/conversation_events`, served on MCP mount `unibox.inbox`. - name: conversations description: >- Registry package `mcp.unibox/conversations`, served on MCP mount `unibox.inbox`. - name: messages description: >- Registry package `mcp.unibox/messages`, served on MCP mount `unibox.inbox`. - name: sender_profiles description: >- Registry package `mcp.unibox/sender_profiles`, served on MCP mount `unibox.sender-profiles`. - name: tasks description: Registry package `mcp.unibox/tasks`, served on MCP mount `unibox.inbox`. - name: timeline description: >- Registry package `mcp.unibox/timeline`, served on MCP mount `unibox.inbox`. paths: /api/agent-runs/{sid}: get: tags: - agent_runs summary: Get agent run description: >- One AI SDR run, as the Analyzer's drawer opens it: include made answers how its reply was made in six steps (read, plan, gather, write, check, sent: what the turn read, decided, wrote and was checked by), beside reply, trigger, lead and scenario. A rewrite's test run reads running until it is done (its words in record.text) or failed. Contract: - MCP tool `get_agent_run`, registry package `mcp.unibox/agent_runs`, mount `unibox.agent`. - Operation `get`, response envelope `get`. - Flags: read only. operationId: get_agent_run parameters: - name: sid in: path required: true description: The ub_rn_* sid of the row to read. schema: type: string minLength: 18 maxLength: 18 pattern: ^ub_rn_ description: The ub_rn_* sid of the row to read. - name: include[] in: query required: false description: >- The search's reply, trigger, lead, scenario and hints, and made: how the reply was made in six steps (read, plan, gather, write, check, sent), from this run, the run that wrote its words and the classify that read the message. style: form explode: true schema: type: array items: type: string enum: - reply - trigger - lead - scenario - hints - then - made description: >- The search's reply, trigger, lead, scenario and hints, and made: how the reply was made in six steps (read, plan, gather, write, check, sent), from this run, the run that wrote its words and the classify that read the message. responses: '200': description: '`get` success envelope.' content: application/json: schema: $ref: '#/components/schemas/GetAgentRunResponse' 4XX: $ref: '#/components/responses/McpClientError' 5XX: $ref: '#/components/responses/McpServerError' components: schemas: GetAgentRunResponse: type: object properties: success: type: boolean enum: - true operation: type: string enum: - get item: type: object properties: sid: type: string description: Agent run sid (ub_rn_…). team_sid: type: string description: Owning team (ts_tm_…, external - gs.service.id). agent_sid: type: string nullable: true description: >- The AI SDR the turn ran as (ub_ag_…), frozen at the dispatch (block 10, 2026-10-30); null on a row from before. conversation_sid: type: string description: The thread this work ran on (ub_cv_…). kind: type: string enum: - classify - plan - execute_step - dialog_reply description: >- classify = one debounced classification of an inbound burst; plan = a strategize turn that builds or replaces the thread plan; execute_step = one due plan step; dialog_reply = one goal-led live-dialog reply. state: type: string enum: - pending - running - done - failed - canceled description: >- pending = armed, waiting for execute_at or a queue slot; running = claimed; done / failed / canceled are terminal. A turn that reports a failure after its message or its plan was written is done, not tried again: the work stands. canceled = the work was no longer wanted (the lead wrote again, the plan was canceled or replaced, or a person rewrote the step the run was working for). failed means the retries were exhausted and the escalation policy fired. execute_at: type: string nullable: true description: >- ISO 8601 UTC the run is due at (the debounce or timer clock); null = run now. Sort ascending over pending rows to see what fires next. trigger_message_sid: type: string nullable: true description: >- The newest inbound message that armed a classify or dialog_reply (ub_ms_…). It is the freshness anchor: a newer inbound cancels the run at claim time. trigger_signal: type: string nullable: true enum: - awaiting_reply - opened_not_replied - clicked_not_replied - multi_opened - accepted_not_replied - note_read_not_replied - reacted_not_replied - invited_us - followed_us - lead_messaged_first - unanswered_inbound - draft_pending - escalated_open - task_overdue - went_quiet - reactivated - invite_pending - connection_removed - blocked_us - deleted_message - bounced - bounced_hard - complained - booking_link_sent - objective_reached - viewed_our_profile - visited_our_site - visited_not_replied - visited_key_page - multi_visited - submitted_form - company_visited_our_site - no_people - thin_coverage - nobody_reached - no_engagement - no_reply - exhausted - dormant - dm_missing description: >- The signal that armed a plan run when no reply did (accepted_not_replied, reacted_not_replied or clicked_not_replied): the thread gained the name and the agent owes it a move, strategized under the signal_followup behavior. Null on every other run; a classify landing on the thread re-arms the run and clears it. scenario_key: type: string nullable: true description: >- The platform scenario the classify matched, max 64 chars (the vocabulary is owned by conversations). null on non-classify runs. confidence: type: number nullable: true minimum: 0 maximum: 1 description: >- Classification confidence, 0..1. Below the platform floor it trips the low_confidence escalation. extracted: type: object nullable: true properties: return_date: type: string description: 'Out of office: the ISO 8601 date the prospect is back.' resume_date: type: string description: 'Not now: the ISO 8601 date the prospect said to come back.' proposed_time: type: string description: >- Meeting or reschedule ask: the time the prospect proposed, in their own words ("next week", "Thursday 15:00 CET"), never converted to a timestamp. referred_contact: type: object properties: name: type: string description: Their name, as the reply gave it. role: type: string description: Their role or title, as the reply gave it. email: type: string description: Their email address, as the reply gave it. ln_nickname: type: string description: >- LinkedIn vanity slug, the name after linkedin.com/in/, lowercased. ln_id: type: string description: >- LinkedIn profile URN (ACoAA…), when the reply linked the profile by it. sn_id: type: string description: >- Sales Navigator URN (ACwAA…), from a Sales Navigator link. recruiter_id: type: string description: Recruiter URN (AEMAA…), from a Recruiter link. ln_member_id: type: string description: >- The member id a URN decodes to, digits only: one person across the three URNs. description: >- Referral or wrong person: the person the prospect pointed at. A LinkedIn link is never stored, only the identity it resolves to. objection_topic: type: string description: >- Objection: what the prospect objected to, in a few words of their own. objection_kind: type: string enum: - price - timing - has_solution - other description: >- Objection family (AgentRunObjectionKindEnum), when one clearly fits. Logged for analysis; it is not a scenario of its own. description: >- Entities the classify pulled out of the reply; null when nothing was extracted. reason: type: string nullable: true description: >- The model's own explanation of the decision, max 512 chars. This is what the thread timeline pill renders, and what to quote when a user disputes a classification. custom_scenario_sid: type: string nullable: true description: >- The custom scenario that matched (ub_sc_…), which takes precedence over the built-in behavior; null when none did. behavior: type: string nullable: true enum: - answer_interested - meeting_request_book - answer_info_request - referral_capture - not_now_defer - ooo_delay_ping - auto_reply_skip - wrong_person_referral - reschedule_meeting - cancel_meeting - return_to_orchestration - close_not_interested - handle_objection - stoplist_do_not_contact - vendor_pitch_skip - acknowledge_low_signal - followup_no_reply - signal_followup - followup_after_person description: >- The built-in competence module driving a plan or execute run; null on classify runs and on custom-scenario-driven work. behavior_version: type: integer nullable: true minimum: 1 description: >- Version of that module at run time: the audit stamp that makes a past decision reproducible. playbook_source: type: string nullable: true enum: - platform - edited - custom description: >- Whose playbook the run planned under (2026-10-12): platform (the seed as it ships), edited (the team's version of it) or custom (a scenario of the team's own with steps of its own). Stamped on a classify run that planned a mechanical playbook by rule and on a plan run whose pack resolved one; null on every other run. playbook_version: type: integer nullable: true minimum: 1 description: >- That playbook's version: the seed's, or 1 on a custom scenario's own steps. With behavior_version, the audit says which version of whose playbook planned. plan_sid: type: string nullable: true description: >- The plan created (kind plan) or executed (kind execute_step), ub_pl_…; null otherwise. step_id: type: integer nullable: true minimum: 1 description: >- Which step of plan_sid this run executed, or the use_playbook step a Playbook turn rides; null on a run outside a plan. dialog_turn: type: string nullable: true enum: - reply - stall - followup description: >- What a Playbook dialog turn is for (2026-10-19, ConversationDialogTurnEnum): reply, the reply to the lead's message; stall, the offer the stall rule forces after days of silence; followup, a follow-up after the offer with a new angle (or the one nudge after a yes). Null on every other run. guidance: type: string nullable: true description: >- The user's "try again, but..." steering on a regenerate, max 1024 chars. It rides the turn's context pack. regenerates_message_sid: type: string nullable: true description: >- The draft the user discarded (ub_ms_…); its body joins the context pack as the previous draft. llm_log_ref: type: string nullable: true description: >- The runner's transcript of the turn (the SDK's stream, on the runner's host), max 255 chars. It holds no context pack: what a reader needs of the turn is record. error_code: type: string nullable: true description: >- Terminal failure code once the retries are exhausted, max 64 chars; null otherwise. Group failures by it before reading any transcript. cost_usd: type: number nullable: true description: >- What the turn cost on the model in US dollars, as the runner reported it (2026-10-19): the agent's meter. A thread's spend is the sum over its runs, read in credits (25 a dollar) against the agent's credits_cap_per_conversation. Null on a run that never reported and on rows from before. example_sids: type: array nullable: true items: type: string description: >- The golden set rows the turn's pack carried (2026-10-20, ub_eg_…, at most five, golden first): what the reply was written from. Null on a turn that carried none. words_caught: type: array nullable: true items: type: object properties: never: type: string times: type: integer required: - never - times description: >- The Words the send door refused this run's messages for (2026-10-20), each with how often; the turn wrote the sentence again. Null when none. knowledge_miss: type: string nullable: true description: >- A classify run only: the lead's question the Knowledge pick found nothing for above the floor, up to 500 chars. Null otherwise. outcome: type: string nullable: true enum: - written - edited - unsure - waiting - handed - test description: >- What became of the reply the run stands for (2026-10-21, the Analyzer's log): written, edited (a person changed its words before it went), unsure (it went as written and the lead's question found nothing in Knowledge), waiting (a draft waits for an OK), handed (a hand-off took the thread to a person instead), test (a rewrite, never sent). Null: no row of the log. approved_by_user_sid: type: string nullable: true description: >- The person who approved the reply the run stands for, as its message carries it (2026-10-27, block AC8), stamped with the outcome. Null on a reply that went out on its own (the Analyzer's Sent itself) and on a run with no reply. test_of_run_sid: type: string nullable: true description: >- A test run's original (ub_rn_…): the run whose reply rewrite_agent_reply wrote again. Null on every live run. test_sid: type: string nullable: true description: >- The test from a real reply this run is a turn of (ub_at_…, start_agent_test on /mcp/unibox/agent-memory, 2026-10-28): its classify of the lead's message or the reply written after it. Null on every live run and on a rewrite's test run. record: type: object nullable: true properties: read: type: object additionalProperties: {} gather: type: object additionalProperties: {} decision: type: object additionalProperties: {} write: type: object additionalProperties: {} checks: type: array items: type: object additionalProperties: {} tries: type: integer spans: type: array items: type: object additionalProperties: {} mix: type: object additionalProperties: type: number made_by: type: string nullable: true text: type: string nullable: true edit_says: type: object nullable: true additionalProperties: {} files: type: array items: type: object properties: answer_sid: type: string question: type: string name: type: string required: - answer_sid - question - name description: >- The Knowledge files that went out with the reply (block AC3, 2026-10-26): the answer each came with. description: >- What the turn read, decided, wrote and was checked by (2026-10-21), every part optional: read (a classify's ranking, signals, questions, model numbers, hand-off), gather (the pack's inputs, used or only read), decision, write (model, tokens, prompt parts, first draft), checks, tries, spans and mix (what the reply's words came from), made_by (the plan run that wrote a planned send), text (a test run's reply), edit_says, files (the Knowledge files that went out with the reply, block AC3). Null on older runs. hint_sids: type: array nullable: true items: type: string description: >- The Analyzer's hints the run opened or counted on its completion (2026-10-26, ub_hn_…, at most ten; search_agent_hints on /mcp/unibox/agent-memory): a classify's missing answers, a writing turn's missing dialogue. Null on a run that left none. created_at: type: string description: ISO 8601 UTC. updated_at: type: string description: ISO 8601 UTC. required: - sid - team_sid - agent_sid - conversation_sid - kind - state - execute_at - trigger_message_sid - trigger_signal - scenario_key - confidence - extracted - reason - custom_scenario_sid - behavior - behavior_version - playbook_source - playbook_version - plan_sid - step_id - dialog_turn - guidance - regenerates_message_sid - llm_log_ref - error_code - cost_usd - example_sids - words_caught - knowledge_miss - outcome - approved_by_user_sid - test_of_run_sid - test_sid - record - hint_sids - created_at - updated_at included: type: object properties: hints: type: array items: type: object properties: sid: type: string description: The hint (ub_hn_…). kind: type: string description: >- missing_answer (a question nothing in Knowledge answers) or no_example (no close dialogue in the Golden set). subject: type: string description: What was missing, as the lead put it. goes_to: type: string description: 'Where the fix lands: knowledge or golden_set.' scenario_key: type: string nullable: true description: The scenario of the reply that opened it. status: type: string description: open, resolved or dismissed. count: type: integer minimum: 1 description: The real replies that hit it. required: - sid - kind - subject - goes_to - scenario_key - status - count description: >- include hints: the hints the run hit, and the ones the classify that read its trigger hit; absent where both left none. reply: type: object properties: sid: type: string description: The message (ub_ms_…), a split reply's first part. channel: type: string description: linkedin or email. body_text: type: string description: >- Its whole text as it went or waits, a split reply's parts joined. draft_body_text: type: string nullable: true description: >- The agent's own words when a person changed them before it went; null when nobody did. state: type: string description: >- The message state: pending_approval, queued, sent, delivered, failed or canceled. parts: type: integer minimum: 1 description: How many messages it went as. sent_at: type: string nullable: true description: ISO 8601 UTC, when it went; null while it waits. created_at: type: string nullable: true description: ISO 8601 UTC, when it was written. person_edited_at: type: string nullable: true description: >- ISO 8601 UTC, when a person changed it; null when nobody did. approved_by_user_sid: type: string nullable: true description: The user who approved it; null when none did. required: - sid - channel - body_text - draft_body_text - state - parts - sent_at - created_at - person_edited_at - approved_by_user_sid description: 'include reply: the message the run stands for.' trigger: type: object properties: sid: type: string description: The lead's message (ub_ms_…). body_text: type: string description: Its text. sent_at: type: string nullable: true description: ISO 8601 UTC. required: - sid - body_text - sent_at description: >- include trigger: the lead's message it answered (the run's trigger, else the one of the classify that read it). lead: type: object properties: name: type: string nullable: true description: The lead as the thread names them. company: type: string nullable: true description: >- Their company, from the linked playtables person; null when unlinked or unknown. person_sid: type: string nullable: true description: >- The playtables person (cr_pp_…); null when the thread is not linked. required: - name - company - person_sid description: 'include lead: the thread''s lead.' scenario: type: object properties: run_sid: type: string description: The classify run (ub_rn_…). scenario_key: type: string nullable: true description: What the lead's message was read as. confidence: type: number nullable: true description: 0..1. required: - run_sid - scenario_key - confidence description: 'include scenario: what the lead''s message was read as.' then: type: object nullable: true properties: kind: type: string description: >- booked, signed_up, registered (the Playbook's end), their_link, confirmed_time, gave_contact (the lead's own evidence), handed (a person took the thread), replied (the lead wrote again), back_on (the lead named a date and the plan waits until it: at is the date), no_reply. at: type: string nullable: true description: ISO 8601 UTC of what happened; null on no_reply. required: - kind - at description: >- include then (2026-10-27, block AC8): what the lead did after the reply, the thread's outcome read from the reply's send (a run with no reply, a hand-off's classify, from its own time): booked, their_link, confirmed_time, gave_contact, handed, replied, back_on or no_reply, with when. The Analyzer's "The lead then" column. Null where the thread is gone. made: type: object properties: read: type: object nullable: true additionalProperties: {} description: >- The classify that read the lead's message: the message, scenario_key, confidence, reason, knowledge_miss, ranking, signals, model, tokens, ms, hand_off, level (the scenario's level the reply resolved to and the condition that held, block AC4). Null when no classify read it. plan: type: object nullable: true additionalProperties: {} description: >- The plan the reply belongs to (its steps as the plan holds them), the dialog's path through the Playbook's stages with its facts, and the turn's decision. gather: type: object nullable: true additionalProperties: {} description: >- record.gather of the run that wrote the words: the inputs its pack carried, each used or only read, the nearest below the floors. write: type: object nullable: true additionalProperties: {} description: >- record.write of that run: the model, its numbers, the prompt's parts, the first draft. check: type: object nullable: true additionalProperties: {} description: >- checks (words, tracking, plan_rules, task_rule, door with who approved) and tries. sent: type: object nullable: true additionalProperties: {} description: >- The reply as it went: the reply include's fields, changes (a person's edits as ranges over its text), went_out and edit_says. required: - read - plan - gather - write - check - sent description: 'include made: how the reply was made, in six steps.' includes: type: array items: type: string meta: type: object properties: trace_id: type: string description: UUID v7; same 128-bit value as the X-Trace-Id header. span_id: type: string pattern: ^[0-9a-f]{16}$ description: 16 hex chars, root span of this request. timestamp: type: string description: ISO 8601 UTC (Y-m-dTH:i:sZ), response time. duration_ms: type: integer minimum: 0 description: Server-side wall clock. team_sid: type: string nullable: true description: >- The team this call ran in (the token team, or the team_sid override). Null when unauthenticated; absent from pre-2026-08-20 backends. actor_type: type: string nullable: true description: >- user | agent | api_key | system. Null when unauthenticated; absent from pre-2026-08-20 backends. required: - trace_id - span_id - timestamp - duration_ms required: - success - operation - item - included - includes - meta McpError: type: object properties: success: type: boolean enum: - false error: type: object properties: code: type: string enum: - validation_failed - nothing_to_update - not_found - relation_not_found - invalid_transition - limit_exceeded - payment_required - duplicate_rejected - conflict - delete_blocked - unauthorized - forbidden - rate_limited - internal_error - service_unavailable - not_implemented message: type: string recoverable: type: boolean suggestion: type: string field_errors: type: object additionalProperties: type: array items: type: object properties: rule: type: string message: type: string required: - rule - message blockers: type: array items: type: object properties: type: type: string description: >- Machine-readable blocker type (active_flow, pending_tasks, …). severity: type: string enum: - hard - soft description: >- hard = external action required; soft = acknowledge is enough. description: type: string entity_sid: type: string nullable: true count: type: integer resolution: type: string description: 'Hard: tool name to call. Soft: code for acknowledge[].' resolution_hint: type: string required: - type - severity - description - entity_sid - resolution - resolution_hint context: type: object additionalProperties: {} required: - code - message - recoverable meta: type: object properties: trace_id: type: string description: UUID v7; same 128-bit value as the X-Trace-Id header. span_id: type: string pattern: ^[0-9a-f]{16}$ description: 16 hex chars, root span of this request. timestamp: type: string description: ISO 8601 UTC (Y-m-dTH:i:sZ), response time. duration_ms: type: integer minimum: 0 description: Server-side wall clock. team_sid: type: string nullable: true description: >- The team this call ran in (the token team, or the team_sid override). Null when unauthenticated; absent from pre-2026-08-20 backends. actor_type: type: string nullable: true description: >- user | agent | api_key | system. Null when unauthenticated; absent from pre-2026-08-20 backends. required: - trace_id - span_id - timestamp - duration_ms required: - success - error responses: McpClientError: description: >- MCP error envelope. `error.code` is one of validation_failed, nothing_to_update, not_found, relation_not_found, invalid_transition, limit_exceeded, payment_required, duplicate_rejected, conflict, delete_blocked, unauthorized, forbidden, rate_limited, not_implemented. content: application/json: schema: $ref: '#/components/schemas/McpError' McpServerError: description: >- MCP error envelope with `error.code` internal_error or service_unavailable. content: application/json: schema: $ref: '#/components/schemas/McpError' securitySchemes: BearerJwt: type: http scheme: bearer bearerFormat: JWT description: >- Access token issued by gs.service.id. Its `access_identity` claim carries `team_sid`, `actor_sid` and `actor_type`, and that team scope is authoritative. TeamSid: type: apiKey in: header name: Team-SID description: >- Team scope for tokens that do not carry one. Ignored when the token already names a team. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.