Skip to content

FCE-3775 Document videoCodec Sandbox API parameter - #288

Merged
Gawor270 merged 2 commits into
mainfrom
fce-3775-sandbox-video-codec
Sep 25, 2026
Merged

Gawor270 merged 2 commits into
mainfrom
fce-3775-sandbox-video-codec

Conversation

@Gawor270

Copy link
Copy Markdown
Member

Description

The Sandbox API now accepts an optional videoCodec query parameter.

  • Explain in the rooms page that Sandbox API rooms default to VP8 and can use H.264 via videoCodec
  • List videoCodec and its 409 conflict behavior in the Sandbox API testing guide

@linear

linear Bot commented Sep 23, 2026

Copy link
Copy Markdown

FCE-3775

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The published OpenAPI reference omits videoCodec and its 409 conflict behavior.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 1 Low severity

Open (1)
What changed in this PR

Documents Sandbox API video codec selection, including VP8 defaults, H.264 overrides, and 409 conflict behavior.

Changes:

  • Adds videoCodec guidance to the Sandbox API testing guide.
  • Explains codec defaults and overrides on the rooms page.
File Summary
docs/​how-to/​backend/​sandbox-api-testing.mdx Documents the optional codec parameter and 409 behavior.
docs/​explanation/​rooms.mdx Describes Sandbox API codec defaults and overrides.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/how-to/backend/sandbox-api-testing.mdx
@Gawor270
Gawor270 marked this pull request as ready for review September 23, 2026 11:42
Gawor270 added a commit to fishjam-cloud/web-client-sdk that referenced this pull request Sep 25, 2026
## Description

- Add an optional `options` argument (`{ videoCodec }`) to
`getSandboxPeerToken` and `getSandboxLivestream`, after the existing
`roomType` / `isPublic` arguments
- Send `videoCodec` (`vp8` | `h264`) with both requests
- Show a clear error when the room already exists with a different room
type or video codec (409)
- Export `VideoCodec` and `SandboxOptions` from react-client and
mobile-client

## Motivation and Context

The Sandbox API now accepts a `videoCodec` query parameter; compositions
need H.264 rooms.

## Documentation impact

- [ ] Documentation update required
- [x] Documentation updated [in another
PR](fishjam-cloud/documentation#288)
- [ ] No documentation update required

## Types of changes

- [ ] Bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to
      not work as expected)
@Gawor270
Gawor270 merged commit bc1448e into main Sep 25, 2026
2 checks passed
@Gawor270
Gawor270 deleted the fce-3775-sandbox-video-codec branch September 25, 2026 13:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants