Other

List the people in the organisation

GEThttps://backend.immut.io/api/v1/users

Required scope: users:read

Use it to attribute a document to a real person, or to name reviewers in a report. Requires the users:read scope, which is NOT granted to agent keys by default: an admin adds it deliberately, because an agent that protects files does not need to know the staff list. Returns 403 INSUFFICIENT_SCOPE without it.

Responses

Status	Meaning
`200`	Success Returns: per row: name, email, role, suspended, createdAt, lastLogin, plus meta {page, limit, total, totalPages}. Members of YOUR organisation only. Pending invitations are merged in, so a row may exist for someone who has not accepted yet.
`400`	BadRequest
`401`	Unauthorized
`403`	Forbidden
`429`	RateLimited

Example

curl -X GET "https://backend.immut.io/api/v1/users" \
  -H "Authorization: Bearer $IMMUT_API_KEY"

Generated from the immut API contract, version 1.11.0. Machine-readable: this page as markdown · everything in one file · OpenAPI