Skip to main content
PATCH
Update a package draft

Authorizations

Authorization
string
header
required

Batch Relay scoped API key or an anonymous Test Mode session. Scope names document required capabilities. Anonymous sessions are sandbox-only and do not authorize studio, event, billing, or Live Mode operations.

Headers

X-BatchRelay-Delegated-Authorization
string

Original delegated Clerk OAuth bearer. Go independently verifies signature/current revocation, exact resource audience, allowed OAuth client and action scope. Caller must match attributed API key creator. Never send an unverified subject header.

X-BatchRelay-Client-Surface
string

Untrusted optional analytics hint naming the calling client surface. It never affects authorization, routing, pricing, or behavior.

Required string length: 1 - 100
X-BatchRelay-Client-Version
string

Untrusted optional analytics hint naming the calling client version. It never affects authorization, routing, pricing, or behavior.

Required string length: 1 - 100
X-BatchRelay-Invocation-Mode
string

Untrusted optional analytics hint naming the invocation mode. It never affects authorization, routing, pricing, or behavior.

Required string length: 1 - 100

Path Parameters

studio_id
string
required

Stable public studio ID beginning with stu_. The API never selects a studio implicitly; a local CLI profile name is not a studio ID.

Required string length: 5 - 256
Pattern: ^stu_[A-Za-z0-9_-]+$
package_id
string
required
Required string length: 1 - 256

Body

application/json
expected_edit_version
integer
required
Required range: x >= 1
add_ons
object[]
description
string
expected_source_fingerprint
string

Required for delegated Live edits; use the target resource edit_fingerprint.

Pattern: ^[a-f0-9]{64}$
lines
object[]
media_asset_ids
string[]
name
string
Required string length: 1 - 240
price
object
sort_order
integer
Required range: x >= 0

Response

Updated package draft

add_ons
object[]
required
availability
object
required
edit_version
integer
required
id
string
required
lines
object[]
required
media_asset_ids
string[]
required
name
string
required
price
object
required
status
string
required
description
string
edit_fingerprint
string

Current resource fingerprint for guarded delegated Live edits and publication.

Pattern: ^[a-f0-9]{64}$
pending_draft_id
string

On direct published-resource GET, identifies an existing draft in the same Studio and lane.

sort_order
integer