Label Studio

Label Studio Subpackage Projects.subpackage Projects/roles API

The subpackage_projects.subpackage_projects/roles API from Label Studio — 3 operation(s) for subpackage_projects.subpackage_projects/roles.

Documentation GitHub OpenAPI

Operations 4

GET /api/projects/roles/ ✨ List project roles for current user #

POST /api/projects/roles/ ✨ Create project role for user #

DELETE /api/projects/roles/{id}/ ✨ Remove project role for user #

GET /api/projects/{id}/roles ✨ List project roles #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/label-studio-subpackage-projects-subpackage-projects-roles-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Reference Subpackage Projects.subpackage Projects/roles API
  version: 1.0.0
servers:
- url: http://localhost:8000
tags:
- name: subpackage_projects.subpackage_projects/roles
paths:
  /api/projects/roles/:
    get:
      operationId: list
      summary: ✨ List project roles for current user
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        List project roles for requested IDs for the current user'
      tags:
      - subpackage_projects.subpackage_projects/roles
      parameters:
      - name: ids
        in: query
        required: false
        schema:
          type: integer
      - name: ordering
        in: query
        description: Which field to use when ordering the results.
        required: false
        schema:
          type: string
      - name: Authorization
        in: header
        description: '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>'
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ProjectRole'
    post:
      operationId: add
      summary: ✨ Create project role for user
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Create project role for user allowing the user the same access level provided by organization role.'
      tags:
      - subpackage_projects.subpackage_projects/roles
      parameters:
      - name: Authorization
        in: header
        description: '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>'
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Role created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectRole'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProjectRoleRequest'
  /api/projects/roles/{id}/:
    delete:
      operationId: remove
      summary: ✨ Remove project role for user
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Remove project role for user allowing the user the same access level provided by organization role.'
      tags:
      - subpackage_projects.subpackage_projects/roles
      parameters:
      - name: id
        in: path
        description: A unique integer value identifying this project role.
        required: true
        schema:
          type: integer
      - name: Authorization
        in: header
        description: '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>'
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response
  /api/projects/{id}/roles:
    get:
      operationId: get
      summary: ✨ List project roles
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        List users and their project level roles for a given project.

        If user is not listed here and is a member of the project then they would behave as assigned role in organization.'
      tags:
      - subpackage_projects.subpackage_projects/roles
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
      - name: Authorization
        in: header
        description: '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>'
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ProjectRole'
components:
  schemas:
    ProjectRole:
      type: object
      properties:
        id:
          type: integer
        project:
          type: integer
        role:
          $ref: '#/components/schemas/Role9e7Enum'
        user:
          type: integer
      required:
      - id
      - project
      - role
      - user
      title: ProjectRole
    ProjectRoleRequest:
      type: object
      properties:
        project:
          type: integer
        role:
          $ref: '#/components/schemas/Role9e7Enum'
        user:
          type: integer
      required:
      - project
      - role
      - user
      title: ProjectRoleRequest
    Role9e7Enum:
      type: string
      enum:
      - OW
      - AD
      - MA
      - RE
      - AN
      - DI
      - 'NO'
      description: '* `OW` - Owner

        * `AD` - Administrator

        * `MA` - Manager

        * `RE` - Reviewer

        * `AN` - Annotator

        * `DI` - Deactivated

        * `NO` - Not Activated'
      title: Role9e7Enum
  securitySchemes:
    Token:
      type: apiKey
      in: header
      name: Authorization
      description: '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>'