SuperAI Flow Platform

Sections

Theme switcher

List organization users

Header Parameters

Authorizationstring

Path Parameters

organization_idstring Required

Unique identifier of the organization to query users from. Organization must exist in database.

Response

200
Object
List of organization users retrieved successfully

Response Attributes

created_atstring Required

Timestamp when user was created (ISO 8601 UTC).

emailstring Required

User's email address. Unique within organization. Used for login and notifications.

first_namestring Required

User's first name. Used in UI displays and emails.

idstring Required

Unique identifier for the user. Format: UUID v4

last_namestring Required

User's last name. Used in UI displays and emails.

modified_bystring Required

Identifier of the user or system that last modified this user. Used for audit trail.

organization_idstring Required

UUID of the organization this user belongs to.

organization_namestring Required

Display name of the user's organization. Included for convenience to avoid additional API calls. Useful in user lists and dashboards showing cross-organization data.

rolestring Required

User's role within the organization. Values: 'org_admin', 'backoffice', 'app_user', 'integration'

statusstring Required

User's account status. Values: 'active', 'inactive'. 'active' users can log in; 'inactive' users cannot.

updated_atstring Required

Timestamp when user was last modified (ISO 8601 UTC).

400
Object
Invalid UUID format

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
403
Object
Forbidden - Insufficient permissions to access this resource

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
404
Object
Organization not found

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
422
Object
Validation Error

Response Attributes

detailarray

Show child attributes

500
Object
Internal Server Error - An unexpected error occurred

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
Was this section helpful?

What made this section unhelpful for you?

GET

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?

View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot