Skip to main content

Create a new organization

POST 
/api/v1/orgs

Add a new organization with the provided details.

Parameters

  • Request body: CreateUpdateOrgDto with organization information.
  • input (CreateUpdateOrgDto, required): the organization definition, including:
    • Name (string, required, max length 100): the name of the organization.
    • parentOrgId (string, optional): the ID of the parent organization, if applicable.

Responses

  • 201 Created: new organization created successfully.
  • 400 Bad Request: invalid input data.
  • 403 Forbidden: caller does not have permission to create orgs under the specified parent.
  • 404 Not Found: specified parent organization not found.
  • 409 Conflict: organization name already exists.

Security

  • This API requires authentication.

Request​

Responses​

Created