OCT-103 Gumlet outreach
POST/video/sources/live/{live_workspace_id}

Update a live stream workspace

Updates a live stream workspace. Supply name, video_source_id, or both to change the collection name or its associated video-on-demand workspace. The response contains the updated workspace details.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 2 body fields
live_workspace_idstringrequired

The unique identifier of the live stream workspace to update.

Live stream workspace fields to update. Supply name, video_source_id, or both.

namestringoptional

Live stream collection name

video_source_idstringoptional

Video on demand workspace ID

4 status codes
200Returns the updated live stream workspace, including its ID, name, creation timestamp, update timestamp, and associated video workspace ID when available.
created_atstringrequired

Creation timestamp in ISO 8601 format

idstringrequired

LIve stream workspace ID

namestringrequired

Name of the live stream workspace

updated_atstringrequired

Update timestamp in ISO 8601 format

video_workspace_idstringoptional

Video workspace ID attached to this collection.

400Returned when the request is invalid.

One documented failure

  • source_not_found

    Could not find any video source with the specified source_id.

errorobjectrequired
401Returned when the request omits or supplies an invalid API key or bearer token.

One documented failure

  • invalid_api_key

    API key supplied with request is invalid

errorobjectrequired
403Returned when the account is unpaid or the authenticated user has insufficient role permissions.

One documented failure

  • unauthorized

    You don't have access to this feature. Please contact your organization owner.

errorobjectrequired

Error handling

A 400 is returned when the request is invalid. A 401 is returned when the request omits or supplies an invalid API key or bearer token. A 403 is returned for an unpaid account or insufficient role permissions. The live_workspace_id path parameter identifies the workspace; the optional body fields are name and video_source_id.