POST /api/v1/organizationsRequires a valid Bearer token. No organization-level permission is needed — this is a user-level action. The caller is automatically assigned the owner role in the new organization.
Request body Display name for the organization. Example: Acme Corp.
Response The newly created organization. Show OrganizationSummary properties
UUID of the organization.
URL-safe identifier auto-generated from the name.
The caller’s role in this organization. Always owner for the creating user. One of owner, admin, developer, analyst, or viewer.
Errors Status When 400Request body is invalid or missing required fields 401Missing or invalid Bearer token
Example curl -X POST http://localhost:8080/api/v1/organizations \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{"name": "Acme Corp"}'
{ "organization" : { "id" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890" , "slug" : "acme-corp" , "name" : "Acme Corp" , "role" : "owner" } }