> ## Documentation Index > Fetch the complete documentation index at: https://widgetic.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Managed Users > Retrieve the managed users you manage, with pagination support. (Admins see every partner's managed users.) ## OpenAPI ````yaml /openapi/widgetic-api-public.json get /managed-users openapi: 3.0.0 info: title: Widgetic API Gateway version: 1.0.0 description: API documentation for the Widgetic API Gateway license: name: Widgetic Integration License url: https://docs.widgetic.com/resources/license servers: - url: https://api.widgetic.com/v1 description: Production server variables: env: default: production description: Environment apiUrl: default: https://api.widgetic.com description: API URL apiVersion: default: /v1 description: API Version path prefix security: [] tags: [] paths: /managed-users: get: tags: - Managed Users summary: Get Managed Users description: >- Retrieve the managed users you manage, with pagination support. (Admins see every partner's managed users.) operationId: getAllManagedUsers parameters: - in: query name: page schema: type: integer minimum: 1 default: 1 description: Page number for pagination - in: query name: size schema: type: integer minimum: 1 maximum: 100 default: 10 description: Number of items per page - in: query name: sort schema: type: string default: createdAt:desc description: >- Sort field and direction, `:`. The field is `createdAt`, `updatedAt` or `externalId` (the snake_case spellings `created_at`, `updated_at` and `external_id` work too); `asc` or `desc` alone sorts by `createdAt`. Any other field is a 400. responses: '200': description: Successful retrieval of managed users content: application/json: schema: type: object properties: success: type: boolean data: type: array items: $ref: '#/components/schemas/ManagedUser' meta: $ref: '#/components/schemas/ResponseMeta' required: - success - data '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: >- Forbidden - Partner access required. A partner sees only the managed users they manage. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - apiKeyAuth: [] x-code-samples: - lang: TypeScript label: TypeScript SDK source: > import { Configuration, ManagedUsersApi } from '@widgetic/api-sdk-ts'; const config = new Configuration({ apiKey: 'YOUR_API_KEY' }); const managedUsersApi = new ManagedUsersApi(config); try { const response = await managedUsersApi.getAllManagedUsers({ page: 1, size: 10 }); console.log('Managed users:', response.data); console.log('Total:', response.meta?.total); console.log('Current page:', response.meta?.page); } catch (error) { if (error.response?.status === 401) { console.error('Authentication required'); } else { console.error('Failed to fetch managed users:', error); } } components: schemas: ManagedUser: type: object description: > A managed user as the API answers. The answer names its fields in camelCase (`externalId`), and so does the request that creates or changes a managed user; the snake_case spelling (`external_id`) is read too. required: - id - managerId - externalId - createdAt - updatedAt properties: id: type: string format: uuid description: Unique identifier for the managed user example: 123e4567-e89b-12d3-a456-426614174000 managerId: type: string format: uuid description: ID of the user who manages this managed user example: 123e4567-e89b-12d3-a456-426614174001 externalId: type: string description: >- Your own identifier for the managed user. Unique among the managed users you manage (two different partners may use the same value). example: external-user-123 metadata: type: object description: Additional metadata for the managed user example: firstName: John lastName: Doe role: editor isActive: type: boolean nullable: true description: > Whether new compositions, widgets and uploads can be filed under this managed user. `false` means it has been switched off (`updateManagedUser` with `is_active: false`): what it already has stays, and filing anything new under it answers `409 MANAGED_USER_INACTIVE`. A record from before the switch existed may answer `null`, which counts as on. example: true createdAt: type: string format: date-time description: Timestamp when the managed user was created example: '2023-01-01T00:00:00Z' updatedAt: type: string format: date-time description: Timestamp when the managed user was last updated example: '2023-01-02T00:00:00Z' example: id: 123e4567-e89b-12d3-a456-426614174000 managerId: 123e4567-e89b-12d3-a456-426614174001 externalId: external-user-123 metadata: firstName: John lastName: Doe role: editor isActive: true createdAt: '2023-01-01T00:00:00Z' updatedAt: '2023-01-02T00:00:00Z' ResponseMeta: type: object description: >- Extra information about the answer: where a page sits in a list, the cursor of the next page, or warnings about a call that succeeded with a caveat. additionalProperties: true properties: page: type: integer description: The page that was read, counting from 1. example: 1 size: type: integer description: How many items one page holds. example: 20 total: type: integer description: How many items the whole list has. example: 135 limit: type: integer description: The same as `size`. example: 20 offset: type: integer description: How many items come before this page. example: 0 hasNextPage: type: boolean example: true hasPreviousPage: type: boolean example: false nextCursor: type: string nullable: true description: >- Pass this as `cursor` to read the next page of a list that is read by cursor. `null` on the last page. warnings: type: array items: type: string description: >- Things the call did not do, though it succeeded (for example a table that could not be created just now). ErrorResponse: type: object required: - success - message - error additionalProperties: true properties: success: type: boolean description: Always `false` on a failure. example: false message: type: string description: The same text as `error.message`, for a caller that reads one line. error: $ref: '#/components/schemas/ErrorDetail' ErrorDetail: type: object required: - code - message - timestamp properties: code: type: string description: Machine-readable error code. example: RESOURCE_NOT_FOUND message: type: string description: Human-readable explanation. example: Composition not found param: type: string description: The field that caused the error, when one did. example: name docUrl: type: string description: Where this error is explained. suggestedAction: type: string description: What to do about it. retryAfter: type: integer description: >- Seconds to wait before trying again (rate limits). The same number is in the `Retry-After` header. example: 60 details: type: object additionalProperties: true description: >- More about the error: the fields that failed, a limit that was reached. correlationId: type: string description: Quote this when you ask support about the call. example: req_123e4567-e89b-12d3-a456-426614174000 timestamp: type: string format: date-time example: '2026-10-15T10:00:00.000Z' securitySchemes: apiKeyAuth: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.