Update organisation

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

Update an organisation's plan, trial length, or subscription status. Accepts partial updates — only provided fields are mutated.

Mutable Fields

  • plan — trial, sole_trader, limited_company
  • trialDays — 0–365, sets trial_ends_at to NOW() + N days
  • subscriptionStatus — trialing, active, past_due, canceled, unpaid

Returns 400 if no fields are provided, 404 if the organisation does not exist.

Side Effects

  • Writes ORG_UPDATED to admin_audit_log with the update payload as details

Warning

This bypasses Stripe. Use the billing endpoints (cancel-subscription, retry-payment) for Stripe-synchronised changes. This endpoint is for manual overrides only.

Path parameters

id string required

Response

200 Organisation updated.

Error codes

400 No fields to update.
404 Organisation not found.