Skip to main content
POST
Remove several resources at once

Authorizations

X-API-Key
string
header
required

A Streamloop API key (sl_…). It carries no workspace: send X-Workspace-Id too (400 WORKSPACE_REQUIRED otherwise).

Headers

Idempotency-Key
string

Retry safely: the key (per caller, workspace, method and path) is taken before the request runs, and its first answer is replayed for 24 hours, with Idempotency-Replayed: true — a repeat sent while the first still runs waits for it. The same key with a different body is 422 IDEMPOTENCY_KEY_REUSED. A 5xx is not kept: the retry runs.

Maximum string length: 200
X-Workspace-Id
string

The workspace to act in. Required with an API key; otherwise the session's own.

Path Parameters

id
string
required

The scene's id (scn_…)

Pattern: ^scn_

Body

application/json
paths
string[]
required
Minimum array length: 1
revisions
object

Response

The answer

What a draft operation answers. summary says what happened in a sentence; value is what a read found.

summary
string
value
object

What was read: a resource (with revision and children), a type (what it takes), or a list

path
string

A write: where it is stored (a new id is made unique)

revision
string

A write: the resource's new revision

frameRevision
string

A layer's write: the revision of the frame/<id> it is in (If-Match takes either)

created
boolean
diff
string

A write: a unified diff of what changed

removed
string[]
draftRevision
string

The whole draft as this answer saw it: publish takes it