Users reference

Users endpoint authentication, parameters, request and response contracts.

Last updated:

On this pagePATCH /api/users/{uid}POST /api/users/{uid}/logout

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.

PATCH /api/users/{uid}

Update user

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

Parameters

NameLocationTypeRequired
uidpathintegerYes

Request body

application/json

FieldTypeRequiredDescription
usernamestring | nullNo
full_namestring | nullNo
emailstring | nullNo
rolestring | nullNo
activeboolean | nullNo
passwordstring | nullNo

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

FieldTypeRequiredDescription
detailValidationError[]No

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

POST /api/users/{uid}/logout

End user sessions

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

Parameters

NameLocationTypeRequired
uidpathintegerYes

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

FieldTypeRequiredDescription
detailValidationError[]No

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