Organization API: Catalog & Services: Staff

Part of Catalog & Services.

POST /api/v1/orgs/{org_slug}/staff/services/{service_id}/cancel

Cancel on the customer's behalf: the same sequence their own button runs, credit for unused time included, with the staff member on the audit row.

application/json

POST /api/v1/orgs/{org_slug}/staff/services/{service_id}/cancel-plan-change

GET /api/v1/orgs/{org_slug}/staff/services/{service_id}/cancel-preview

POST /api/v1/orgs/{org_slug}/staff/services/{service_id}/change-plan

Move the service to another plan of the same cycle. An upgrade raises the prorated invoice the customer pays; a downgrade credits the wallet under the credit policy. The customer's own flow, run by staff.

application/json (required)

PATCH /api/v1/orgs/{org_slug}/staff/services/{service_id}/due-date

Move the next renewal. Extending is goodwill; pulling it in is a correction. Only the organization's service moves: the platform service behind it has no due date of its own, because Coritan charges the organization wholesale when its customer's invoice is paid (app.billing.wholesale), and a date there would start the platform's invoice run billing the organization's owner at list price.

application/json (required)

GET /api/v1/orgs/{org_slug}/staff/services/{service_id}/notes

POST /api/v1/orgs/{org_slug}/staff/services/{service_id}/notes

application/json (required)

GET /api/v1/orgs/{org_slug}/staff/services/{service_id}/plan-options

GET /api/v1/orgs/{org_slug}/staff/services/{service_id}/plan-preview

POST /api/v1/orgs/{org_slug}/staff/services/{service_id}/retry-provision

Re-queue provisioning for an order stuck before it had a server.

The order must be this brand's, still pending, provisioning or failed, have no live server yet, be paid for (or never invoiced), and have no provision job already queued for it: paying is what starts provisioning, and this must not be a way around that, whatever the order's status says.

POST /api/v1/orgs/{org_slug}/staff/services/{service_id}/suspend

Suspend an active service. Support and above; audited. The reason is shown to the customer. 400 for a service that is not active, 404 for one of another organization, and 429 past 120 suspensions an hour per staff member.

application/json

POST /api/v1/orgs/{org_slug}/staff/services/{service_id}/terminate

End a service now with no cancellation credit. This is for abuse, fraud, or a refund already made. Admin only, after a step-up (403 reauth_required otherwise); the reason is kept and audited. 404 for a service of another organization, and 429 past 30 an hour per staff member.

application/json (required)

POST /api/v1/orgs/{org_slug}/staff/services/{service_id}/unsuspend

Lift a suspension and call off any deletion date it carried. Support and above; audited. 400 for a service that is not suspended, 404 for one of another organization, and 429 past 120 an hour per staff member.