For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
EnterpriseQuick Start
API ReferenceTutorials
  • Introduction
    • Getting started
  • API Reference
      • POSTReset organization token
      • GETList your organizations
      • GETGet organization settings
      • PATCH✨ Update organization
      • PATCH✨ Update default role
        • GET✨ Get organization members/roles
        • PATCH✨ Update organization member/role
        • GETGet organization member details
        • DELSoft delete an organization member
LogoLogo
EnterpriseQuick Start
API ReferenceOrganizationsMembers

✨ Get organization members/roles

GET
http://localhost:8000/api/organizations/:id/memberships
GET
/api/organizations/:id/memberships
$curl http://localhost:8000/api/organizations/1/memberships \
>     -H "Authorization: Token  <api_key>" \
>     -H "Content-Type: application/json"
200Retrieved
1{
2  "count": 3,
3  "results": [
4    {
5      "concurrency": "2024-06-01T12:00:00Z",
6      "contributed_to_projects": [
7        {
8          "id": 101,
9          "title": "Image Annotation Project"
10        },
11        {
12          "id": 102,
13          "title": "Text Classification"
14        }
15      ],
16      "created_projects": [
17        {
18          "id": 101,
19          "title": "Image Annotation Project"
20        }
21      ],
22      "id": 501,
23      "organization": 1,
24      "role": "AD",
25      "role_source": "manual",
26      "tags": [
27        {
28          "id": 10,
29          "label": "Team Lead"
30        },
31        {
32          "id": 12,
33          "label": "Remote"
34        }
35      ],
36      "user": {
37        "avatar": "https://labelstud.io/avatars/user501.png",
38        "id": 501,
39        "initials": "AJ",
40        "last_activity": "2024-05-30T16:20:00Z",
41        "lse_fields": {
42          "email_notification_settings": "daily_summary",
43          "invite_expired": "false",
44          "invite_expired_at": "2024-12-31T23:59:59Z",
45          "invite_activated": true,
46          "invited_at": "2023-11-15T10:00:00Z",
47          "invited_by": 100,
48          "onboarding_state": "complete",
49          "social_auth_finished": true,
50          "trial_company": "Tech Innovators Inc.",
51          "trial_experience_labeling": "Experienced with image and text labeling",
52          "trial_license_enterprise": true,
53          "trial_models_in_production": "Object detection, Sentiment analysis",
54          "trial_role": "business_analyst"
55        },
56        "pause": "none",
57        "username": "alice.jones",
58        "contributed_to_projects": [
59          {
60            "id": 101,
61            "title": "Image Annotation Project"
62          },
63          {
64            "id": 103,
65            "title": "Audio Transcription"
66          }
67        ],
68        "created_projects": [
69          {
70            "id": 101,
71            "title": "Image Annotation Project"
72          }
73        ],
74        "active_organization": 1,
75        "allow_newsletters": true,
76        "custom_hotkeys": null,
77        "date_joined": "2023-11-20T08:45:00Z",
78        "email": "alice.jones@example.com",
79        "first_name": "Alice",
80        "last_name": "Jones",
81        "phone": "+1-555-123-4567"
82      },
83      "user_type": "internal"
84    },
85    {
86      "concurrency": "2024-06-01T12:05:00Z",
87      "contributed_to_projects": [
88        {
89          "id": 104,
90          "title": "Video Annotation"
91        }
92      ],
93      "created_projects": [],
94      "id": 502,
95      "organization": 1,
96      "role": "AN",
97      "role_source": "manual",
98      "tags": [
99        {
100          "id": 15,
101          "label": "Contractor"
102        }
103      ],
104      "user": {
105        "avatar": "https://labelstud.io/avatars/user502.png",
106        "id": 502,
107        "initials": "BS",
108        "last_activity": "2024-05-28T11:15:00Z",
109        "lse_fields": {
110          "email_notification_settings": "none",
111          "invite_expired": "false",
112          "invite_expired_at": "2025-01-31T23:59:59Z",
113          "invite_activated": true,
114          "invited_at": "2024-02-05T09:30:00Z",
115          "invited_by": 501,
116          "onboarding_state": "first_tutorial",
117          "social_auth_finished": false,
118          "trial_company": "Freelance",
119          "trial_experience_labeling": "New to video annotation",
120          "trial_license_enterprise": false,
121          "trial_models_in_production": "",
122          "trial_role": "annotator"
123        },
124        "pause": "none",
125        "username": "bob.smith",
126        "contributed_to_projects": [
127          {
128            "id": 104,
129            "title": "Video Annotation"
130          }
131        ],
132        "created_projects": [],
133        "active_organization": 1,
134        "allow_newsletters": false,
135        "custom_hotkeys": null,
136        "date_joined": "2024-02-10T14:00:00Z",
137        "email": "bob.smith@example.com",
138        "first_name": "Bob",
139        "last_name": "Smith",
140        "phone": "+1-555-987-6543"
141      },
142      "user_type": "external"
143    },
144    {
145      "concurrency": "2024-06-01T12:10:00Z",
146      "contributed_to_projects": null,
147      "created_projects": null,
148      "id": 503,
149      "organization": 1,
150      "role": "RE",
151      "role_source": "import",
152      "tags": [],
153      "user": {
154        "avatar": "https://labelstud.io/avatars/user503.png",
155        "id": 503,
156        "initials": "CW",
157        "last_activity": "2024-05-29T09:00:00Z",
158        "lse_fields": {
159          "email_notification_settings": "weekly_summary",
160          "invite_expired": "false",
161          "invite_expired_at": "2024-11-30T23:59:59Z",
162          "invite_activated": true,
163          "invited_at": "2023-08-25T15:00:00Z",
164          "invited_by": 100,
165          "onboarding_state": "in_app_guidance",
166          "social_auth_finished": true,
167          "trial_company": "Data Insights LLC",
168          "trial_experience_labeling": "Experienced reviewer",
169          "trial_license_enterprise": true,
170          "trial_models_in_production": "Text summarization",
171          "trial_role": "data_scientist"
172        },
173        "pause": "none",
174        "username": "carol.white",
175        "contributed_to_projects": null,
176        "created_projects": null,
177        "active_organization": 1,
178        "allow_newsletters": true,
179        "custom_hotkeys": null,
180        "date_joined": "2023-09-01T12:00:00Z",
181        "email": "carol.white@example.com",
182        "first_name": "Carol",
183        "last_name": "White",
184        "phone": "+1-555-222-3333"
185      },
186      "user_type": "internal"
187    }
188  ],
189  "next": "http://api.labelstud.io/api/organizations/1/memberships/?page=2",
190  "previous": null
191}
<Card href="https://humansignal.com/goenterprise"> <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/> <p style="margin-top: 10px; font-size: 14px;"> This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise) </p> </Card> Retrieve a list of all users and roles in a specific organization.
Was this page helpful?
Previous

✨ Update organization member/role

Next
Built with
Label Studio Enterprise badge

This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise

Retrieve a list of all users and roles in a specific organization.

Authentication

AuthorizationToken
The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example: <br><pre><code class="language-bash">curl https://label-studio-host/api/projects -H "Authorization: Token [your-token]"</code></pre>

Path parameters

idintegerRequired
A unique integer value identifying this organization.

Query parameters

contributed_to_projectsbooleanOptional
Whether to include projects created and contributed to by the members.
exclude_project_idintegerOptional

Project ID to exclude users who are already associated with this project (direct members, workspace members, or implicit admin/owner access).

exclude_workspace_idintegerOptional

Workspace ID to exclude users who are already associated with this workspace (direct workspace members or implicit admin/owner access).

orderingstringOptional
Which field to use when ordering the results.
pageintegerOptional
A page number within the paginated result set.
page_sizeintegerOptional
Number of results to return per page.
rolestringOptional
Filter members by organization role. Accepts single role or comma-separated list of roles. **Format:** - Single role: `?role=RE` - Multiple roles: `?role=AN,RE` (users with ANY of these roles) **Role Codes:** - `OW` = Owner - `AD` = Administrator - `MA` = Manager - `RE` = Reviewer - `AN` = Annotator - `NO` = Not Activated - `DI` = Disabled
scopeenumOptional

Member visibility scope. accessible (default) limits Managers to members in their projects/workspaces. all returns all organization members. Only affects Manager role.

Allowed values:
searchstringOptional
A search term.
tagsstringOptional

Filter members by tags. Use a comma-separated list of tag IDs.

Response

countinteger
resultslist of objects
nextstring or nullformat: "uri"
previousstring or nullformat: "uri"
The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example: 
curl https://label-studio-host/api/projects -H “Authorization: Token [your-token]”

Filter members by organization role. Accepts single role or comma-separated list of roles.

Format:

  • Single role: ?role=RE
  • Multiple roles: ?role=AN,RE (users with ANY of these roles)

Role Codes:

  • OW = Owner
  • AD = Administrator
  • MA = Manager
  • RE = Reviewer
  • AN = Annotator
  • NO = Not Activated
  • DI = Disabled