Label Studio Subpackage Organizations.subpackage Organizations/permissions API

The subpackage_organizations.subpackage_organizations/permissions API from Label Studio — 3 operation(s) for subpackage_organizations.subpackage_organizations/permissions.

Business capability
Identity & Access Management BC-620.20

Operations 7

GET /api/organizations/{id}/permissions ✨ List organization permission overrides #
POST /api/organizations/{id}/permissions ✨ Create organization permission override #
GET /api/organizations/{id}/permissions/options ✨ Get configurable permissions options #
GET /api/organizations/{id}/permissions/{permission} ✨ Retrieve organization permission override #
PUT /api/organizations/{id}/permissions/{permission} ✨ Replace organization permission override #
DELETE /api/organizations/{id}/permissions/{permission} ✨ Delete organization permission override #
PATCH /api/organizations/{id}/permissions/{permission} ✨ Update organization permission override #

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-organizations-subpackage-organizations-permissions-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.

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

OpenAPI Specification

label-studio-subpackage-organizations-subpackage-organizations-permissions-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Reference Subpackage Organizations.subpackage…
  version: 1.0.0
servers:
- url: http://localhost:8000
tags:
- name: subpackage_organizations.subpackage_organizations/permissions
paths:
  /api/organizations/{id}/permissions:
    get:
      operationId: list
      summary: ✨ List organization permission overrides
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        List all organization-level permission overrides for a given organization.'
      tags:
      - subpackage_organizations.subpackage_organizations/permissions
      parameters:
      - name: id
        in: path
        required: true
        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/OrganizationPermission'
    post:
      operationId: create
      summary: ✨ Create organization permission override
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Create a new organization-level permission override for a given organization.'
      tags:
      - subpackage_organizations.subpackage_organizations/permissions
      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:
                $ref: '#/components/schemas/OrganizationPermission'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                description: Any type
        '403':
          description: Permission Denied
          content:
            application/json:
              schema:
                description: Any type
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrganizationPermissionRequest'
  /api/organizations/{id}/permissions/options:
    get:
      operationId: get-options
      summary: ✨ Get configurable permissions options
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Retrieve the list of configurable permission options (label, tooltip, default role and allowed roles).'
      tags:
      - subpackage_organizations.subpackage_organizations/permissions
      parameters:
      - name: id
        in: path
        required: true
        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/ConfigurablePermissionOption'
  /api/organizations/{id}/permissions/{permission}:
    get:
      operationId: get
      summary: ✨ Retrieve organization permission override
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Retrieve the organization-level permission override for a given permission key.'
      tags:
      - subpackage_organizations.subpackage_organizations/permissions
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
      - name: permission
        in: path
        required: true
        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:
                $ref: '#/components/schemas/OrganizationPermission'
        '403':
          description: Permission Denied
          content:
            application/json:
              schema:
                description: Any type
        '404':
          description: Permission not found for organization
          content:
            application/json:
              schema:
                description: Any type
    put:
      operationId: replace
      summary: ✨ Replace organization permission override
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Replace the organization-level permission override for a given permission key.'
      tags:
      - subpackage_organizations.subpackage_organizations/permissions
      parameters:
      - name: id
        in: path
        description: A unique integer value identifying this organization.
        required: true
        schema:
          type: integer
      - name: permission
        in: path
        description: Permission key to update within the organization.
        required: true
        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:
                $ref: '#/components/schemas/OrganizationPermission'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                description: Any type
        '403':
          description: Permission Denied
          content:
            application/json:
              schema:
                description: Any type
        '404':
          description: Permission not found for organization
          content:
            application/json:
              schema:
                description: Any type
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrganizationPermissionRequest'
    delete:
      operationId: delete
      summary: ✨ Delete organization permission override
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Delete the organization-level permission override for a given permission key.'
      tags:
      - subpackage_organizations.subpackage_organizations/permissions
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
      - name: permission
        in: path
        required: true
        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: Successful response
        '403':
          description: Permission Denied
          content:
            application/json:
              schema:
                description: Any type
        '404':
          description: Permission not found for organization
          content:
            application/json:
              schema:
                description: Any type
    patch:
      operationId: update
      summary: ✨ Update organization permission override
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Partially update the organization-level permission override for a given permission key.'
      tags:
      - subpackage_organizations.subpackage_organizations/permissions
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
      - name: permission
        in: path
        required: true
        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:
                $ref: '#/components/schemas/OrganizationPermission'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                description: Any type
        '403':
          description: Permission Denied
          content:
            application/json:
              schema:
                description: Any type
        '404':
          description: Permission not found for organization
          content:
            application/json:
              schema:
                description: Any type
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedOrganizationPermissionRequest'
components:
  schemas:
    ConfigurablePermissionOption:
      type: object
      properties:
        default:
          type: array
          items:
            $ref: '#/components/schemas/Role9e7Enum'
        group:
          type: string
        label:
          type: string
        options:
          type: array
          items:
            $ref: '#/components/schemas/Role9e7Enum'
        permission:
          type: string
        tooltip:
          type: string
      required:
      - default
      - options
      - permission
      title: ConfigurablePermissionOption
    OrganizationPermissionRequest:
      type: object
      properties:
        permission:
          type: string
        roles:
          type: array
          items:
            $ref: '#/components/schemas/Role9e7Enum'
          description: Organization roles
      required:
      - permission
      title: OrganizationPermissionRequest
    PatchedOrganizationPermissionRequest:
      type: object
      properties:
        permission:
          type: string
        roles:
          type: array
          items:
            $ref: '#/components/schemas/Role9e7Enum'
          description: Organization roles
      title: PatchedOrganizationPermissionRequest
    Default165Enum:
      type: string
      enum:
      - OW
      - AD
      - MA
      - RE
      - AN
      - DI
      - 'NO'
      title: Default165Enum
    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
    Options165Enum:
      type: string
      enum:
      - OW
      - AD
      - MA
      - RE
      - AN
      - DI
      - 'NO'
      title: Options165Enum
    OrganizationPermission:
      type: object
      properties:
        default:
          type: array
          items:
            $ref: '#/components/schemas/Default165Enum'
        group:
          type:
          - string
          - 'null'
        id:
          type: integer
        label:
          type:
          - string
          - 'null'
        options:
          type: array
          items:
            $ref: '#/components/schemas/Options165Enum'
        organization:
          type: integer
        permission:
          type: string
        roles:
          type: array
          items:
            $ref: '#/components/schemas/Role9e7Enum'
          description: Organization roles
        tooltip:
          type:
          - string
          - 'null'
      required:
      - default
      - group
      - id
      - label
      - options
      - organization
      - permission
      - tooltip
      title: OrganizationPermission
  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>'