---
title: "Update Payout"
method: POST
path: "/payouts/{payout_id}"
tags: ["payouts"]
---

# Update Payout

`POST /payouts/{payout_id}`

## Path parameters

- `payout_id` integer, required

## Request body

- PayoutUpdateRequest
  - `status` 'PENDING' | 'APPROVED' | 'PAID' | 'EMAILED'
  - `line_items` LineItem[], nullable
    - `name` string, required
    - `usd` integer, required

## Response `200`

Successful Response

- PayoutDetail
  - `payout_id` integer, required
  - `created_at` string, date-time, required
  - `status` 'PENDING' | 'APPROVED' | 'PAID' | 'EMAILED', required
  - `line_items` LineItem[], required
    - `name` string, required
    - `usd` integer, required
  - `organization` OrganizationBasic, required
    - `organization_id` string, uuid, required
    - `name` string, required
    - `created_at` string, date-time, required
    - `num_members` integer
    - `active_member_count` integer
    - `representative` OrganizationRepresentative
      - `user_id` string, required
      - `name` string, required
      - `email` string, required
      - `deactivated` boolean
    - `pay_rate_usd` integer, nullable
    - `recording_review` boolean
    - `is_personal` boolean
    - `compliance_enabled` boolean
    - `fund_type` 'LONG_SHORT' | 'LONG_ONLY' | 'MARKET_NEUTRAL' | 'MULTI_STRATEGY'
    - `portfolio_style` 'CONCENTRATED' | 'DIVERSIFIED'
    - `time_horizon` 'SHORT_TERM' | 'MEDIUM_TERM' | 'LONG_TERM'
    - `subscription_status` 'INCOMPLETE' | 'INCOMPLETE_EXPIRED' | 'TRIALING' | 'ACTIVE' | 'PAST_DUE' | 'CANCELED' | 'UNPAID' | 'PAUSED'
    - `subscription_expires_at` string, date-time, nullable
    - `subscription_recurring` boolean, nullable
    - `renewal_terms_prepared` boolean
    - `subscription_terms_has_agreement` boolean
    - `subscription_terms_unsigned` boolean
    - `subscription_terms_signed_at` string, date-time, nullable
    - `subscription_terms_created_at` string, date-time, nullable
    - `note` Note
      - `note_id` string, uuid, required
      - `text` string, nullable
    - `deactivated` boolean
    - `has_open_invites` boolean
    - `latest_invoice` StripeInvoiceBasic
      - `id` string, required
      - `status` 'draft' | 'open' | 'paid' | 'void' | 'uncollectible'
      - `due_date` string, date-time, nullable
      - `amount_due_cents` integer
    - `latest_subscription` StripeSubscriptionBasic
      - `id` string, required
      - `status` 'active' | 'canceled' | 'incomplete' | 'incomplete_expired' | 'paused' | 'past_due' | 'trialing' | 'unpaid'
    - `product_trial_ends_at` string, date-time, nullable
  - `calls` AdminCall[], required
    - `call_id` string, uuid, required
    - `participants` AdminParticipant[]
      - `association_id` string, uuid, required
      - `user_id` string, nullable
      - `guest_id` string, uuid, nullable
      - `guest_name` string, nullable
      - `guest_email` string, nullable
      - `role` 'PRIMARY' | 'SECONDARY' | 'GUEST', required
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `note` Note
        - `note_id` string, uuid, required
        - `text` string, nullable
      - `user_note` string, nullable
      - `is_first_call` boolean, nullable
      - `status` 'PENDING' | 'CONFIRMED' | 'DECLINED'
      - `updated_at` string, date-time, nullable
      - `last_calendar_update` string, date-time, nullable
      - `analyst_call_name` string, nullable
      - `association_source_id` string, uuid, nullable
      - `call_request_history` AdminParticipantCallRequestHistory
        - `status` 'OPEN' | 'PAUSED' | 'CLOSED', required
        - `familiarity` 'NOT_WELL' | 'SOMEWHAT' | 'VERY_WELL', required
        - `position` 'NONE' | 'BEAR' | 'BULL' | 'SKEPTIC', required
        - `is_priority` boolean, required
        - `is_high_conviction` boolean, required
        - `notes` string, nullable
        - `is_open_for_multiple_calls` boolean, nullable
        - `call_ticker_lead_id` string, uuid, nullable
      - `call_ticker_lead` AdminParticipantCallTickerLead
        - `source` string, uuid, required
    - `ticker` string, required
    - `status` 'SCHEDULING' | 'CONFIRMED' | 'CANCELLED' | 'RESCHEDULING' | 'ARCHIVED', required
    - `call_link` string, nullable, required
    - `call_date` string, date-time, nullable, required
    - `calendar_event_id` string, nullable
    - `note` Note
      - `note_id` string, uuid, required
      - `text` string, nullable
    - `transcript_ids` string[]
    - `call_status_history` CallStatusHistory[], nullable
      - `status` 'SCHEDULING' | 'CONFIRMED' | 'CANCELLED' | 'RESCHEDULING' | 'ARCHIVED', required
      - `call_date` string, date-time, nullable, required
      - `requester_user_id` string, nullable, required
      - `actor_user_id` string, nullable, required
      - `reason_note` string, nullable
      - `created_at` string, date-time, required
    - `is_priority` boolean
    - `priority_info` object
    - `is_live_session` boolean
    - `awaiting_schedule_user_ids` string[]
    - `has_overlapping_availability` boolean
    - `admin_action_required` boolean

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.dev/trytrata/apis/fastapi.md) · [All operations](https://skmtc.dev/trytrata/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trytrata/fastapi/revisions/a8ae8846c411/schema)