---
title: "Change who may start work from the tracker"
method: PATCH
path: "/billing/settings"
tags: ["billing"]
---

# Change who may start work from the tracker

`PATCH /billing/settings`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/billing/settings`
- Auth: none declared

## Request body

- UpdateBillingSettingsRequest
  - `orgId` string
  - `trackerTriggers` 'anyone' | 'linked_members', required

## Response `200`

Updated summary

- BillingSummary
  - `orgId` string, required
  - `plan` 'trial' | 'sponsored' | 'team' | 'enterprise', required
  - `cohort` 'friend' | 'design-partner' | 'enterprise-trial' | 'investor' | 'internal', required
  - `mode` 'enforce' | 'shadow' | 'off', required
  - `balance` integer, required
  - `sources` CreditSource[], required
    - `kind` 'trial' | 'sponsored' | 'plan' | 'contract' | 'purchase', required
    - `remaining` integer, required
    - `expiresAt` integer, nullable, required
  - `low` boolean, required
  - `canStartMission` boolean, required
  - `canManage` boolean, required
  - `coveredByShip` boolean, required
  - `missionCeiling` integer, required
  - `sandboxLimit` integer, nullable, required
  - `projects` object, required
    - `used` integer, required
    - `limit` integer, nullable, required
  - `trackerTriggers` 'anyone' | 'linked_members', required
  - `usage` BillingUsage, required
    - `periodDays` integer, required
    - `credits` integer, required
    - `missions` integer, required: Missions the org started in the window, each counted once however many times it restarted. Always 0 while billing is off for the org (`mode` `off`), which meters no mission.
    - `valueUsd` number, required
    - `perCreditUsd` number, required
    - `basis` 'packs' | 'team' | 'purchases', required: The price `perCreditUsd` is: `team`, the org's plan rate; `purchases`, what the org paid per credit; `packs`, the lowest per-credit pack price (the org bought nothing).
    - `estimate` true, required
  - `openCreditRequest` CreditRequestSummary, required
    - `id` string, required
    - `createdAt` integer, required
    - `messageCount` integer, required
  - `creditRequestsGoTo` 'founder' | 'billing_contacts', required
  - `purchase` BillingPurchaseState, required
    - `available` boolean, required
    - `reason` 'checkout_closed' | 'plan_not_purchasable' | 'billing_manage_required', nullable, required
    - `credits` 'packs' | 'team_credits', nullable, required
    - `team` boolean, required
  - `subscription` TeamSubscription, required
    - `plan` 'starter' | 'scale', required
    - `name` string, required
    - `priceUsd` number, required
    - `creditsPerMonth` integer, required
    - `perCreditUsd` number, required
    - `agentsAtOnce` integer, required
    - `status` 'incomplete' | 'active' | 'past_due' | 'canceled', required
    - `nextPlan` SubscribedPlan, required
      - `plan` 'starter' | 'scale', required
      - `name` string, required
      - `priceUsd` number, required
      - `creditsPerMonth` integer, required
      - `perCreditUsd` number, required
      - `agentsAtOnce` integer, required
    - `currentPeriodEnd` integer, nullable, required
    - `cancelAtPeriodEnd` boolean, required
  - `advice` PlanAdvice, required
    - `kind` 'start' | 'switch', required
    - `plan` 'starter' | 'scale', required
    - `name` string, required
    - `priceUsd` number, required
    - `agentsAtOnce` integer, required
    - `periodDays` integer, required
    - `credits` integer, required
    - `currentCostUsd` number, required
    - `planCostUsd` number, required
    - `savingsUsd` number, required
  - `trial` BillingTrialState, required
    - `status` 'not_applicable' | 'awaiting_repository' | 'granted' | 'not_eligible', required
    - `reason` 'invited' | 'identity_used', nullable, required
    - `credits` integer, required

## Other responses

- `401`: Unauthenticated
- `403`: Caller lacks billing:manage (code billing_manage_required)
- `404`: Not one of the caller's orgs

---

[API](https://skmtc.dev/letsship/apis/ship-api.md) · [All operations](https://skmtc.dev/letsship/apis/ship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsship/apis/ship-api/revisions/e6eac1bcadd4?raw)