Label Studio

Label Studio Subpackage Workspaces API

The subpackage_workspaces API from Label Studio — 2 operation(s) for subpackage_workspaces.

Documentation GitHub OpenAPI

Operations 5

GET /api/workspaces/ ✨ List workspaces #

POST /api/workspaces/ ✨ Create workspace #

GET /api/workspaces/{id}/ ✨ Get workspace #

DELETE /api/workspaces/{id}/ ✨ Delete workspace #

PATCH /api/workspaces/{id}/ ✨ Update workspace #

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:label-studio-subpackage-workspaces-api"

All apis

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

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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 Workspaces API
  version: 1.0.0
servers:
- url: http://localhost:8000
tags:
- name: subpackage_workspaces
paths:
  /api/workspaces/:
    get:
      operationId: list
      summary: ✨ List workspaces
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        List all workspaces for your organization. Workspaces in Label Studio let you organize your projects and users into separate spaces. This is useful for managing different teams, departments, or projects within your organization. For more information, see the Workspaces documentation.'
      tags:
      - subpackage_workspaces
      parameters:
      - name: include_all_workspaces
        in: query
        description: Include all workspaces in the organization, including other users' personal workspaces. Only effective for users with Administrator or Owner role. When enabled, the response includes created_by_user info for personal workspaces.
        required: false
        schema:
          type: boolean
      - name: is_archived
        in: query
        description: Filter by archived status. Set to false to exclude archived workspaces.
        required: false
        schema:
          type: boolean
      - name: is_personal
        in: query
        description: Workspace is a personal user workspace.
        required: false
        schema:
          type: boolean
      - 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/Workspace'
    post:
      operationId: create
      summary: ✨ Create workspace
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Create a new workspace. Workspaces in Label Studio let you organize your projects and users into separate spaces. This is useful for managing different teams, departments, or projects within your organization. For more information, see the Workspaces documentation.'
      tags:
      - subpackage_workspaces
      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: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Workspace'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceRequest'
  /api/workspaces/{id}/:
    get:
      operationId: get
      summary: ✨ Get workspace
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Retrieve details for a specific workspace by ID.'
      tags:
      - subpackage_workspaces
      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/Workspace'
    delete:
      operationId: delete
      summary: ✨ Delete workspace
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Delete a specific workspace by ID.'
      tags:
      - subpackage_workspaces
      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: Successful response
    patch:
      operationId: update
      summary: ✨ Update workspace
      description: 'This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise


        Update settings for a specific workspace by ID.'
      tags:
      - subpackage_workspaces
      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/Workspace'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedWorkspaceRequest'
components:
  schemas:
    WorkspaceRequest:
      type: object
      properties:
        color:
          type:
          - string
          - 'null'
          description: Color
        description:
          type:
          - string
          - 'null'
          description: Workspace description
        is_archived:
          type: boolean
          description: Workspace is archived
        is_personal:
          type: boolean
          description: Workspace is a personal user workspace
        title:
          type: string
          description: Workspace Name
      required:
      - title
      description: 'A ModelSerializer that takes additional arguments for

        "fields", "omit" and "expand" in order to

        control which fields are displayed, and whether to replace simple

        values with complex, nested serializations'
      title: WorkspaceRequest
    PatchedWorkspaceRequest:
      type: object
      properties:
        color:
          type:
          - string
          - 'null'
          description: Color
        description:
          type:
          - string
          - 'null'
          description: Workspace description
        is_archived:
          type: boolean
          description: Workspace is archived
        is_personal:
          type: boolean
          description: Workspace is a personal user workspace
        title:
          type: string
          description: Workspace Name
      description: 'A ModelSerializer that takes additional arguments for

        "fields", "omit" and "expand" in order to

        control which fields are displayed, and whether to replace simple

        values with complex, nested serializations'
      title: PatchedWorkspaceRequest
    Workspace:
      type: object
      properties:
        color:
          type:
          - string
          - 'null'
          description: Color
        created_by:
          type: integer
        created_by_user:
          type: string
        description:
          type:
          - string
          - 'null'
          description: Workspace description
        id:
          type: integer
        is_archived:
          type: boolean
          description: Workspace is archived
        is_personal:
          type: boolean
          description: Workspace is a personal user workspace
        membership:
          type: string
        projects_count:
          type:
          - integer
          - 'null'
        title:
          type: string
          description: Workspace Name
      required:
      - created_by
      - created_by_user
      - id
      - membership
      - projects_count
      - title
      description: 'A ModelSerializer that takes additional arguments for

        "fields", "omit" and "expand" in order to

        control which fields are displayed, and whether to replace simple

        values with complex, nested serializations'
      title: Workspace
  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>'
x-provenance:
  method: harvested
  publisher: Label Studio
  source: https://api.labelstud.io/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)