Users
User management — invite, list, update roles, disable/re-enable.
Returns all users. Requires owner or admin role.
Authorization
bearer_auth In: header
Query Parameters
Search users
Sort field
Sort direction
Page size
int64Page offset
int64Response Body
application/json
application/json
curl -X GET "https://example.com/v1/users"{ "total": 0, "users": [ { "avatar_url": "string", "created_at": 0, "display_name": "string", "email": "string", "id": "string", "role": "owner", "status": "active", "updated_at": 0 } ]}Creates a new user with invited status. Requires owner or admin role.
Authorization
bearer_auth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/users/invite" \ -H "Content-Type: application/json" \ -d '{ "email": "string", "role": "string" }'{ "user": { "avatar_url": "string", "created_at": 0, "display_name": "string", "email": "string", "id": "string", "role": "owner", "status": "active", "updated_at": 0 }}Returns the profile of the currently authenticated user.
Authorization
bearer_auth In: header
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/users/me"{ "user": { "avatar_url": "string", "created_at": 0, "display_name": "string", "email": "string", "id": "string", "role": "owner", "status": "active", "updated_at": 0 }}Soft-deletes a user. Requires owner or admin role.
Authorization
bearer_auth In: header
Path Parameters
User ID
Response Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/users/string"{ "ok": true}Re-enables a previously disabled user.
Authorization
bearer_auth In: header
Path Parameters
User ID
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/users/string/enable"{ "user": { "avatar_url": "string", "created_at": 0, "display_name": "string", "email": "string", "id": "string", "role": "owner", "status": "active", "updated_at": 0 }}Changes a user's role. Requires owner or admin role.
Authorization
bearer_auth In: header
Path Parameters
User ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X PATCH "https://example.com/v1/users/string/role" \ -H "Content-Type: application/json" \ -d '{ "role": "string" }'{ "user": { "avatar_url": "string", "created_at": 0, "display_name": "string", "email": "string", "id": "string", "role": "owner", "status": "active", "updated_at": 0 }}