Open Inventory / Docs
EndpointsOrganizationsOrganizations

Create an organization for the current browser user

The API runs on your application instance. Schemas and field names come directly from the OpenAPI specification. Session-authenticated requests require a session on that instance.

POST
/organizations

Authorization

adminSession
cookieauthjs.session-token<token>

Authenticated Auth.js browser session cookie; each operation declares its required permission. Not restricted to administrators. HTTPS deployments use the secure-prefixed cookie variant.

Header Parameters

X-Organization-ID?string

Organization membership selected for this request. User-bound credentials may select any active membership; standalone tokens may only repeat their pinned organization ID.

Formatuuid

Request Body

application/json
  1. body
name*string
Length1 <= length <= 160
slug?string

Optional short Webapp URL slug; generated from the name when omitted.

Match^[a-z0-9]+(?:-[a-z0-9]+)*$
Length1 <= length <= 48

Response Body

Organization created with the current user as admin

application/json
  1. response
organization*
Example Request
curl -X POST 'https://inventory.example.com/api/v1/organizations' \  -H 'Content-Type: application/json' \  -d '{  "name": "string"}'
Example Response
{  "organization": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "slug": "string",    "role": "string",    "roleName": "string",    "isReadOnly": true,    "allowNegativeStock": true,    "canManage": true  }}