Organisations reference

Organisations endpoint authentication, parameters, request and response contracts.

Last updated: 10 November 2026

On this page

GET /api/orgs POST /api/orgs PATCH /api/orgs/{oid}GET /api/orgs/{oid}/birim-fiyatlar PUT /api/orgs/{oid}/birim-fiyatlar GET /api/orgs/{oid}/users POST /api/orgs/{oid}/users

Paths, methods, parameters and available schemas are generated from the OpenAPI document in the repository.

Note: These endpoints form the browser application contract and do not provide the same versioning assurance as v1. Use the versioned API for external integrations.

GET `/api/orgs`

List organisations

Authentication: User session (cookie). Scope: Relevant organisation/project membership and operation permission; writes also check the current role, module and licence permissions.

Responses

HTTP 200

application/json

This OpenAPI document does not define a body schema. See the relevant developer guide for details.

For error meanings and client actions, see the error code glossary.

POST `/api/orgs`

Create organisation

Authentication: User session (cookie). Scope: Relevant organisation/project membership and operation permission; writes also check the current role, module and licence permissions.

Request body

application/json

Field	Type	Required
`name`	string \| null	No
`slug`	string \| null	No
`active`	boolean \| null	No
`limits`	object \| null	No
`settings`	object \| null	No

Responses

HTTP 200

application/json

This OpenAPI document does not define a body schema. See the relevant developer guide for details.

HTTP 422

application/json

Field	Type	Required	Description
`detail`	ValidationError[]	No

For error meanings and client actions, see the error code glossary.

PATCH `/api/orgs/{oid}`

Update organisation

Authentication: User session (cookie). Scope: Relevant organisation/project membership and operation permission; writes also check the current role, module and licence permissions.

Parameters

Name	Location	Type	Required
`oid`	path	integer	Yes

Request body

application/json

Field	Type	Required
`name`	string \| null	No
`slug`	string \| null	No
`active`	boolean \| null	No
`limits`	object \| null	No
`settings`	object \| null	No

Responses

HTTP 200

application/json

This OpenAPI document does not define a body schema. See the relevant developer guide for details.

HTTP 422

application/json

Field	Type	Required	Description
`detail`	ValidationError[]	No

For error meanings and client actions, see the error code glossary.

GET `/api/orgs/{oid}/birim-fiyatlar`

Get unit prices

Authentication: User session (cookie). Scope: Relevant organisation/project membership and operation permission; writes also check the current role, module and licence permissions.

Parameters

Name	Location	Type	Required
`oid`	path	integer	Yes

Responses

HTTP 200

application/json

This OpenAPI document does not define a body schema. See the relevant developer guide for details.

HTTP 422

application/json

Field	Type	Required	Description
`detail`	ValidationError[]	No

For error meanings and client actions, see the error code glossary.

PUT `/api/orgs/{oid}/birim-fiyatlar`

Update unit prices

Authentication: User session (cookie). Scope: Relevant organisation/project membership and operation permission; writes also check the current role, module and licence permissions.

Parameters

Name	Location	Type	Required
`oid`	path	integer	Yes

Request body

application/json

Type: nesne.

{
  "title": "Body"
}

Responses

HTTP 200

application/json

This OpenAPI document does not define a body schema. See the relevant developer guide for details.

HTTP 422

application/json

Field	Type	Required	Description
`detail`	ValidationError[]	No

For error meanings and client actions, see the error code glossary.

GET `/api/orgs/{oid}/users`

Organisation users

Authentication: User session (cookie). Scope: Relevant organisation/project membership and operation permission; writes also check the current role, module and licence permissions.

Parameters

Name	Location	Type	Required
`oid`	path	integer	Yes

Responses

HTTP 200

application/json

This OpenAPI document does not define a body schema. See the relevant developer guide for details.

HTTP 422

application/json

Field	Type	Required	Description
`detail`	ValidationError[]	No

For error meanings and client actions, see the error code glossary.

POST `/api/orgs/{oid}/users`

Create user

Authentication: User session (cookie). Scope: Relevant organisation/project membership and operation permission; writes also check the current role, module and licence permissions.

Parameters

Name	Location	Type	Required
`oid`	path	integer	Yes

Request body

application/json

Field	Type	Required
`username`	string \| null	No
`full_name`	string \| null	No
`email`	string \| null	No
`role`	string \| null	No
`active`	boolean \| null	No
`password`	string \| null	No

Responses

HTTP 200

application/json

This OpenAPI document does not define a body schema. See the relevant developer guide for details.

HTTP 422

application/json

Field	Type	Required	Description
`detail`	ValidationError[]	No

For error meanings and client actions, see the error code glossary.