---
title: "Instruct Post Call Package Stage"
method: POST
path: "/gtm-internal/post-call-packages/{doc_id}/instruct"
tags: ["gtm-internal"]
---

# Instruct Post Call Package Stage

`POST /gtm-internal/post-call-packages/{doc_id}/instruct`

## Request

- Base URL: `https://api-v1.unusual.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-v1.unusual.ai/gtm-internal/post-call-packages/{doc_id}/instruct`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

The free-text instruction box (constraint 4): ONE structured LLM call
revises the stage per the OPERATOR's directive (trusted — unlike the
transcript), the result passes back through the SAME stage validator
(quote gates, book whitelists, recipient whitelist), and downstream
stages are marked stale. Package-local in both modes.

SLOW: the LLM turn runs 30-120s — the handler is async and holds no DB
session across it (package_apply's load → close → LLM → fresh-session
persist); callers should use a generous client timeout.

## Path parameters

- `doc_id` string, required

## Request body

- PackageInstructRequest
  - `stage` 'a' | 'b' | 'c', required
  - `text` string, required

## Response `200`

Successful Response

- PostCallPackageDetail
  - `row` PostCallPackageRow, required
    - `doc_id` string, required
    - `title` string, required
    - `display_title` string
    - `account` string, nullable
    - `account_id` string, nullable
    - `owner` string, nullable
    - `doc_created_at` string, nullable
    - `generated_at` string, nullable
    - `call_type` string, nullable
    - `call_type_confidence` string, nullable
    - `error` boolean
    - `apply_mode` string
    - `stage_a` PackageStageCounts, required: One stage's compact projection (post_call_package.package_summary).
      - `present` boolean
      - `error` boolean
      - `error_type` string, nullable
      - `events` integer
      - `valid` integer
      - `invalid` integer
      - `approved` integer
      - `killed` integer
      - `stale` boolean
      - `sent` boolean, nullable
      - `open_questions` integer, nullable
      - `observations` integer, nullable
    - `stage_b` PackageStageCounts, required: One stage's compact projection (post_call_package.package_summary).
      - `present` boolean
      - `error` boolean
      - `error_type` string, nullable
      - `events` integer
      - `valid` integer
      - `invalid` integer
      - `approved` integer
      - `killed` integer
      - `stale` boolean
      - `sent` boolean, nullable
      - `open_questions` integer, nullable
      - `observations` integer, nullable
    - `stage_c` PackageStageCounts, required: One stage's compact projection (post_call_package.package_summary).
      - `present` boolean
      - `error` boolean
      - `error_type` string, nullable
      - `events` integer
      - `valid` integer
      - `invalid` integer
      - `approved` integer
      - `killed` integer
      - `stale` boolean
      - `sent` boolean, nullable
      - `open_questions` integer, nullable
      - `observations` integer, nullable
    - `narrative_present` boolean
    - `narrative_error` boolean
  - `package` object, required
  - `task_refs` object, required
  - `contact_refs` object
  - `bulk_approvable` object[]
  - `open_tasks` PackageBookTask[]
    - `id` string, required
    - `title` string, required
    - `status` string, nullable
    - `disposition` string, nullable
    - `owner_side` string, nullable
    - `assignee` string, nullable
    - `due_at` string, nullable
    - `created_at` string, nullable
    - `source` string, nullable
    - `priority_id` string, nullable
    - `blocked` boolean
  - `open_tasks_omitted` integer
  - `priorities` PackagePriorityRef[]
    - `id` string, required
    - `title` string, required
    - `disposition` string, nullable
  - `account_state` PackageAccountState: The CURRENT account record the §A delta renders against — the original beside every amendment, and the thing shown UNCHANGED when §A proposes nothing (absence stated, not silent).
    - `company` string, nullable
    - `status` string, nullable
    - `owner` string, nullable
    - `goals` PackageGoalRef[]
      - `id` string, required
      - `title` string, nullable
      - `description` string, nullable
      - `is_primary` boolean
      - `kind` string
      - `status` string, nullable
    - `narrative` string, nullable
  - `meeting_title` string, nullable
  - `call_started_at` string, nullable
  - `apply_result` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/unusual/apis/dashboard-server.md) - [All operations](https://skmtc.dev/unusual/apis/dashboard-server/llms.txt) - [OpenAPI document](https://skmtc.dev/unusual/apis/dashboard-server/revisions/89f716930ead?raw)
