Create a public demo workspace for one company

Provisions a new, permanent Atisbo tenant seeded from a company's own public feedback (no data is invented). Rate limited per IP, per company and globally; all limits fail closed. Returns 422 with code NO_PUBLIC_FOOTPRINT when too little public feedback exists to build a real demo — a product answer, not an error. Creates a permanent tenant, so a network-dropped retry matters: send an Idempotency-Key to get the original response replayed instead of a second tenant.

post/api/demo/provision

Request

  • Base URL: https://app.atisbo.dev
  • URL: https://app.atisbo.dev/api/demo/provision
  • Auth: none declared

Headers

Idempotency-Keystring

Client-generated key (e.g. a UUID). Retrying with the same key and the same body replays the original response rather than provisioning again. The same key with a DIFFERENT body returns 409. Only 200/400/422 outcomes are cached — a 429 is a throttle state, not a fact worth remembering, so retrying after the window passes re-enters the real rate-limit check rather than replaying a stale 429.

X-API-Versionstring
Example:1.0.0

Optional. States which contract version your client was written against. Absent or equal to the current version (1.0.0) changes nothing. A well-formed but different version is accepted: the response keeps reporting the version THAT ANSWERED in x-senso-api-version, and if the requested version is declared deprecated the response additionally carries RFC 8594 Deprecation and Sunset dates. A value that is not three dot-separated integers is rejected with 400 and code invalid_api_version BEFORE the operation runs. Negotiated on this operation only; other /api/* paths ignore the header.

Request body

company_namestring required
company_domainstring

Optional; improves de-duplication and search accuracy.

Response

Demo workspace created.

oktrue required
link_urlstring uri required
seed_totalinteger
notestring

Changes

No recorded changes to this operation across all 1 revision of this API.