Organizations

Setup Organization

Create a new organization and mint a service-account API key for it in a single call. Accepts any regular API key or a session cookie; the returned key is what subsequent /v1/management/* calls for this organization use.

post/v1/management/organizations/setup

Request

  • Base URL: https://api.withone.ai
  • URL: https://api.withone.ai/v1/management/organizations/setup
  • Auth: API key in header X-One-Secret

Request body

descriptionstring nullable

Optional organization description.

keyNamestring nullable

Optional label for the new key (shown in the dashboard's API keys list). When omitted, the key is unnamed.

namestring required

Human-readable organization name.

Response

Organization created with a new service-account API key

Changes

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