Gumlet

Gumlet Live Stream Workspaces API

Create and manage live stream workspaces.

GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /video/sources/live List live stream workspaces · List Workspaces #
Ask an LLM
“What live stream workspaces do I have?”
“Where do I find the id of my live streaming workspace?”
Tell an agent
List my live stream workspaces.
Show all workspaces used for live streaming.
POST /video/sources/live Create a live stream workspace · Create Workspace #
Ask an LLM
“How do I set up a separate workspace for live streaming?”
“Can I create another live workspace for a different team?”
Tell an agent
Create a live stream workspace named {name}.
Set up a new live workspace called {name}.
POST /video/sources/live/{live_workspace_id} Update a live stream workspace · Update Workspace #
Ask an LLM
“Can I rename a live stream workspace?”
“Is it possible to link a live workspace to a video workspace for recordings?”
Tell an agent
Rename live workspace {live_workspace_id} to {name}.
Connect live workspace {live_workspace_id} to video workspace {video_source_id}.
DELETE /video/sources/live/{live_workspace_id} Delete a live stream workspace · Delete Workspace #
Ask an LLM
“Can I delete a live streaming workspace I no longer need?”
“What's the way to remove an unused live workspace?”
Tell an agent destructive · confirm first
Delete live workspace {live_workspace_id}.
Remove the live streaming workspace {live_workspace_id}.

Documentation

📖
Documentation
https://docs.gumlet.com/
📖
APIReference
https://docs.gumlet.com/reference

Specifications

⚙
OpenAPI
https://artifacts.apis.io/gumlet/openapi/gumlet-live-stream-workspaces-api-openapi.yml

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/gumlet:gumlet-live-stream-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

gumlet-live-stream-workspaces-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Gumlet Live Stream Workspaces API
  description: Gumlet helps developers deliver online video and images. This API encompasses Gumlet Video, Image and Video Analytics functionality to help you build your products better and faster than ever before.
  version: '1.4'
  contact:
    name: Gumlet Support Team
    url: https://www.gumlet.com/contact/
    email: support@gumlet.com
  termsOfService: https://www.gumlet.com/terms/
  license:
    name: Apache 2.0
    url: https://opensource.org/license/apache-2.0
  x-scalar-sdk-installation:
  - lang: TypeScript
    description: '```sh

      npm install @gumlet/nodejs-sdk

      ```'
  - lang: Python
    description: '```sh

      pip install gumlet

      ```'
servers:
- url: https://api.gumlet.com/v1
security:
- API_KEY: []
tags:
- name: Live Stream Workspaces
  description: Create and manage live stream workspaces.
paths:
  /video/sources/live:
    get:
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  all_live_sources:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: Live stream workspace name
                        created_at:
                          type: string
                          description: Creation time in ISO 8601 timestamp
                          format: date-time
                        updated_at:
                          type: string
                          format: date-time
                          description: Update time in ISO 8601 timestamp
                        video_workspace_id:
                          type: string
                          description: Video workspace ID that is attached to this collection. Once the live stream completes, the video gets stored in this workspace for long-term storage.
                        id:
                          type: string
                          description: Workspace ID
                      x-apidog-orders:
                      - id
                      - name
                      - created_at
                      - updated_at
                      - video_workspace_id
                      required:
                      - id
                      - name
                      - created_at
                      - updated_at
                      - video_workspace_id
                    description: List of all live stream collections
                x-apidog-orders:
                - all_live_sources
                required:
                - all_live_sources
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
      summary: List Workspaces
      tags:
      - Live Stream Workspaces
      operationId: list-live-workspaces
      description: List all live stream workspaces.
      x-codeSamples:
      - label: TypeScript
        lang: TypeScript
        source: "import Gumlet from '@gumlet/nodejs-sdk';\n\nconst client = new Gumlet({\n  apiKey: process.env['API_KEY'], // defaults to the API_KEY env var\n});\n\nconst liveStreamWorkspace = await client.liveStreamWorkspaces.list();\n\nconsole.log(liveStreamWorkspace);"
      - label: Python
        lang: Python
        source: "import os\n\nfrom gumlet import Gumlet\n\nclient = Gumlet(\n    api_key=os.environ.get(\"API_KEY\"),\n)\n\nlive_stream_workspace = client.live_stream_workspaces.list()\n\nprint(live_stream_workspace)"
    post:
      summary: Create Workspace
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: LIve stream workspace ID
                  video_workspace_id:
                    type: string
                    description: Video workspace ID attached to this collection.
                  created_at:
                    type: string
                    description: Creation timestamp in ISO 8601 format
                    format: date-time
                  name:
                    type: string
                    description: Name of the live stream workspace
                  updated_at:
                    type: string
                    format: date-time
                    description: Update timestamp in ISO 8601 format
                x-apidog-orders:
                - id
                - video_workspace_id
                - created_at
                - name
                - updated_at
                required:
                - id
                - created_at
                - name
                - updated_at
        '400':
          description: Bad Request
          content:
            application/json:
              examples:
                Result:
                  value:
                    error:
                      code: parameter_missing
                      message: One or more required values are missing.
                      param: name
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: parameter_missing
                      message:
                        type: string
                        example: One or more required values are missing.
                      param:
                        type: string
                        example: name
                    required:
                    - code
                    - message
                required:
                - error
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          description: Forbidden — live source limit reached on free/starter plan
          content:
            application/json:
              examples:
                Result:
                  value:
                    error: You have reached the maximum number of live video sources allowed on your plan.
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: You have reached the maximum number of live video sources allowed on your plan.
                required:
                - error
        '422':
          $ref: '#/components/responses/ValidationError'
      operationId: live-workspace-create
      tags:
      - Live Stream Workspaces
      description: Create live stream workspace.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Collection name
              x-apidog-orders:
              - name
              required:
              - name
      x-codeSamples:
      - label: TypeScript
        lang: TypeScript
        source: "import Gumlet from '@gumlet/nodejs-sdk';\n\nconst client = new Gumlet({\n  apiKey: process.env['API_KEY'], // defaults to the API_KEY env var\n});\n\nconst liveStreamWorkspace = await client.liveStreamWorkspaces.create({\n  name: '',\n});\n\nconsole.log(liveStreamWorkspace);"
      - label: Python
        lang: Python
        source: "import os\n\nfrom gumlet import Gumlet\n\nclient = Gumlet(\n    api_key=os.environ.get(\"API_KEY\"),\n)\n\nlive_stream_workspace = client.live_stream_workspaces.create(\n    name=\"\",\n)\n\nprint(live_stream_workspace)"
  /video/sources/live/{live_workspace_id}:
    post:
      parameters:
      - in: path
        name: live_workspace_id
        description: Live stream workspace ID.
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Get updated collection details.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: LIve stream workspace ID
                  video_workspace_id:
                    type: string
                    description: Video workspace ID attached to this collection.
                  created_at:
                    type: string
                    description: Creation timestamp in ISO 8601 format
                    format: date-time
                  name:
                    type: string
                    description: Name of the live stream workspace
                  updated_at:
                    type: string
                    format: date-time
                    description: Update timestamp in ISO 8601 format
                x-apidog-orders:
                - id
                - video_workspace_id
                - name
                - created_at
                - updated_at
                required:
                - id
                - created_at
                - name
                - updated_at
        '400':
          description: Bad Request
          content:
            application/json:
              examples:
                Result:
                  value:
                    error:
                      code: source_not_found
                      message: Could not find any video source with the specified source_id.
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: source_not_found
                      message:
                        type: string
                        example: Could not find any video source with the specified source_id.
                    required:
                    - code
                    - message
                required:
                - error
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
      summary: Update Workspace
      tags:
      - Live Stream Workspaces
      operationId: live-workspace-update
      description: Update live stream workspace.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Live stream collection name
                video_source_id:
                  type: string
                  description: Video on demand workspace ID
              x-apidog-orders:
              - name
              - video_source_id
            examples:
              Example 1:
                value:
                  name: live-stream-collections
                  video_source_id: 67bea1d66ca0059a95bf7de9
      x-codeSamples:
      - label: TypeScript
        lang: TypeScript
        source: "import Gumlet from '@gumlet/nodejs-sdk';\n\nconst client = new Gumlet({\n  apiKey: process.env['API_KEY'], // defaults to the API_KEY env var\n});\n\nconst liveStreamWorkspace = await client.liveStreamWorkspaces.update('liveWorkspaceId');\n\nconsole.log(liveStreamWorkspace);"
      - label: Python
        lang: Python
        source: "import os\n\nfrom gumlet import Gumlet\n\nclient = Gumlet(\n    api_key=os.environ.get(\"API_KEY\"),\n)\n\nlive_stream_workspace = client.live_stream_workspaces.update(\n    live_workspace_id=\"liveWorkspaceId\",\n    name=\"live-stream-collections\",\n    video_source_id=\"67bea1d66ca0059a95bf7de9\",\n)\n\nprint(live_stream_workspace)"
    delete:
      parameters:
      - in: path
        name: live_workspace_id
        description: Live stream workspace ID.
        schema:
          type: string
        required: true
      summary: Delete Workspace
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties: {}
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: Not Found
          content:
            application/json:
              examples:
                Result:
                  value:
                    error:
                      code: source_not_found
                      message: Could not find any video source with the specified source_id.
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: source_not_found
                      message:
                        type: string
                        example: Could not find any video source with the specified source_id.
                    required:
                    - code
                    - message
                required:
                - error
      operationId: live-workspace-delete
      tags:
      - Live Stream Workspaces
      description: Delete the live stream workspace.
      x-codeSamples:
      - label: TypeScript
        lang: TypeScript
        source: "import Gumlet from '@gumlet/nodejs-sdk';\n\nconst client = new Gumlet({\n  apiKey: process.env['API_KEY'], // defaults to the API_KEY env var\n});\n\nconst liveStreamWorkspace = await client.liveStreamWorkspaces.delete('liveWorkspaceId');\n\nconsole.log(liveStreamWorkspace);"
      - label: Python
        lang: Python
        source: "import os\n\nfrom gumlet import Gumlet\n\nclient = Gumlet(\n    api_key=os.environ.get(\"API_KEY\"),\n)\n\nlive_stream_workspace = client.live_stream_workspaces.delete(\n    live_workspace_id=\"liveWorkspaceId\",\n)\n\nprint(live_stream_workspace)"
components:
  responses:
    Unauthorized:
      description: Unauthorized — missing or invalid API key / bearer token
      content:
        application/json:
          examples:
            Result:
              value:
                error:
                  code: invalid_api_key
                  message: API key supplied with request is invalid
          schema:
            $ref: '#/components/schemas/Error'
    ValidationError:
      description: Unprocessable Entity — request validation failed
      content:
        application/json:
          examples:
            Result:
              value:
                error:
                  code: invalid_parameter
                  message: body must have required property '<field>'
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Forbidden — unpaid account or insufficient role permissions
      content:
        application/json:
          examples:
            Result:
              value:
                error:
                  code: unauthorized
                  message: You don't have access to this feature. Please contact your organization owner.
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
              description: Machine-readable error code
            message:
              type: string
              description: Human-readable error message
            param:
              type: string
              description: Optional parameter name related to the error
  securitySchemes:
    API_KEY:
      type: http
      scheme: bearer
x-tagGroups:
- name: Video on Demand
  tags:
  - Video Assets
  - Global Search
  - Multipart Upload
  - Audio Upload
  - Subtitle Upload
  - Recycle Bin
  - Video Workspaces
  - Folders
  - Video Playlists
  - Channel Viewers
  - Video Usage Analytics
  - Video Profiles
  - Webhooks
- name: Live Streams
  tags:
  - Live Stream Workspaces
  - Live Stream Assets
  - Live Stream Analytics
- name: Image APIs
  tags:
  - Image Sources
  - Image Usage Analytics
- name: Video Analytics
  tags:
  - Video Analytics
- name: Webhooks
  tags:
  - Webhooks
- name: Account Endpoints
  tags:
  - User Data
  - Billing
  - Organization Data
  - Audit Logs
x-ext-urls: {}
x-provenance:
  method: harvested
  publisher: Gumlet
  source: https://docs.gumlet.com/reference/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)