नेविगेशन पर जाएँ

Create Reseller Workspace

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

हेडर

xi-api-keystringवैकल्पिक

अनुरोध

This endpoint expects an object.
business_namestringआवश्यक1-100 characters
subscriptionobject or nullवैकल्पिक
Paid tier to subscribe to. Omitted leaves the workspace with no subscription.
phone_numberstring or nullवैकल्पिक
A free number from the reseller's phone pool, reserved for the workspace until onboarding binds it to the receptionist.
memberslist of objectsवैकल्पिकडिफ़ॉल्ट: []

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

complete_onboardingbooleanवैकल्पिकडिफ़ॉल्ट: 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 nullवैकल्पिक<=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.

रिस्पॉन्स

सफल रिस्पॉन्स

workspace_idstring
business_namestring
billing_tierstring or null
receptionist_countinteger
calls_last_30_daysinteger
created_at_unixinteger
subscriptionobject or nullवैकल्पिक

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

has_payment_issuebooleanवैकल्पिकडिफ़ॉल्ट: 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 nullवैकल्पिक
When onboarding finished. Until then the onboarding wizard may replace or remove the workspace's business data.
member_resultslist of objectsवैकल्पिकडिफ़ॉल्ट: []

त्रुटियाँ

422
Unprocessable Entity Error