> ## Documentation Index
> Fetch the complete documentation index at: https://docs.item.app/llms.txt
> Use this file to discover all available pages before exploring further.

# List organization users

> Returns all users in the organization with their IDs and access levels.
Useful for mapping `owned_by_user_id` values or assigning records to users.




## OpenAPI

````yaml /openapi.yaml get /api/meta/users
openapi: 3.1.0
info:
  title: item API
  description: >
    The item API provides full CRUD access to your organization's data — People,
    Companies, and Custom Objects.


    Use it to:

    - Push structured data into item on a schedule

    - Sync custom field values across your stack

    - Pull filtered records and pre-configured views

    - Use item as your source of truth for customer data


    ## Authentication


    All requests require an API key passed in the `x-api-key` header.


    You can generate an API key from **Settings > System > API Key** in your
    item workspace.


    ```bash

    curl -H "x-api-key: sk_live_..." https://app.useitem.io/api/objects/contacts

    ```
  version: 1.0.0
  contact:
    name: item Support
servers:
  - url: https://app.useitem.io
    description: Production
  - url: http://localhost:3000
    description: Local development
security:
  - apiKey: []
tags:
  - name: Objects
    description: Create, read, update, and delete People, Companies, and Custom Objects.
  - name: Schema
    description: Discover available object types and their field definitions.
  - name: Users
    description: List organization members and their access levels.
  - name: Views
    description: List and execute pre-configured views to pull filtered data.
  - name: Batch
    description: Bulk create or update objects for high-frequency sync operations.
  - name: Webhooks
    description: Trigger skills (AI agents) via HTTP webhooks from external systems.
paths:
  /api/meta/users:
    get:
      tags:
        - Users
      summary: List organization users
      description: >
        Returns all users in the organization with their IDs and access levels.

        Useful for mapping `owned_by_user_id` values or assigning records to
        users.
      operationId: listOrganizationUsers
      responses:
        '200':
          description: Users returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/OrganizationUser'
              example:
                data:
                  - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    full_name: Alex Johnson
                    access_level: admin
                  - id: b2c3d4e5-f6a7-8901-bcde-f12345678901
                    full_name: Sarah Chen
                    access_level: member
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    OrganizationUser:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: User ID (auth UUID)
        full_name:
          type: string
          nullable: true
          example: Alex Johnson
        access_level:
          type: string
          enum:
            - admin
            - member
          description: >-
            'member' for standard users, 'admin' for organization admins and
            platform admins
          example: member
    Error:
      type: object
      properties:
        error:
          type: string
          example: Object not found
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your organization's API key (starts with `sk_live_`)

````