Naar navigatie springen

Create Reseller Workspace

Create a workspace for one of your customers, optionally with a tier, a phone number and team invites.

Headers

xi-api-keystringOptioneel

Verzoek

This endpoint expects an object.
business_namestringVerplicht1-100 characters
subscriptionobject or nullOptioneel
Paid tier to subscribe to. Omitted leaves the workspace with no subscription.
phone_numberstring or nullOptioneel
A free number from the reseller's phone pool, reserved for the workspace until onboarding binds it to the receptionist.
memberslist of objectsOptioneelStandaard []

People to invite once the workspace exists, capped by the tier’s team size. Best-effort: each outcome is in member_results.

complete_onboardingbooleanOptioneelStandaard false

Finish setup right away, as POST /v1/reception/reseller/workspaces/{workspace_id}/complete-onboarding does. Best-effort: onboarding_completed_at_unix stays null on failure, and that call can be retried.

idempotency_keystring or nullOptioneel<=255 characters

Client-generated key that makes a retry safe. The same key and body within 24 hours returns the first result without running again. While that first request is still running, a retry gets 409 idempotency_key_in_progress; a different body with the same key gets 400 idempotency_key_reused. A request that fails is not saved, so it can be retried with the same key.

Response

Geslaagde response
workspace_idstring
business_namestring
billing_tierstring or null
receptionist_countinteger
calls_last_30_daysinteger
created_at_unixinteger
subscriptionobject or nullOptioneel

The reseller-managed subscription, when this workspace has one. None means nothing is sold here yet and a tier can be assigned.

has_payment_issuebooleanOptioneelStandaard false
A charge for this workspace is unpaid. Assigning or changing a tier is refused until it clears, so surface it rather than letting it fail.
onboarding_completed_at_unixinteger or nullOptioneel
When onboarding finished. Until then the onboarding wizard may replace or remove the workspace's business data.
member_resultslist of objectsOptioneelStandaard []

Fouten

422
Unprocessable Entity Error