Update organisation

PATCHhttps://app.speybooks.com/api/v1/admin/orgs/{id}

Update an organisation's plan or grace window. Partial updates: only provided fields are mutated.

Mutable fields

  • plan: trial, sole_trader, limited_company
  • trialDays: 0 to 365, setting the cardless grace window (the time to reach Checkout). This is not the Stripe trial, which Stripe owns from Checkout onward.

subscriptionStatus is not mutable here: it is written only by the Stripe subscription webhooks, verbatim. Use cancel-subscription or retry-payment for Stripe-synchronised changes; the webhook writes the resulting status.

Returns 400 if no fields are provided, 404 if the organisation does not exist. Records an ORG_UPDATED action in the audit log with the update payload.

Path parameters

idstringrequired

Response

200Organisation updated.

Error codes

400No fields to update.
404Organisation not found.