Change part of a resource

curl --request PATCH \
  --url https://api.streamloop.app/v1/scenes/{id}/resources/{path} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  {
    "old": "<string>",
    "new": "<string>",
    "field": "<string>"
  }
]
'

import requests

url = "https://api.streamloop.app/v1/scenes/{id}/resources/{path}"

payload = [
    {
        "old": "<string>",
        "new": "<string>",
        "field": "<string>"
    }
]
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify([{old: '<string>', new: '<string>', field: '<string>'}])
};

fetch('https://api.streamloop.app/v1/scenes/{id}/resources/{path}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "summary": "<string>",
  "value": {
    "path": "<string>",
    "revision": "<string>",
    "code": "<string>",
    "name": "<string>",
    "description": "<string>",
    "transition": {
      "kind": "cut",
      "ms": 123
    },
    "sound": "<string>",
    "children": [
      {
        "path": "<string>",
        "description": "<string>",
        "as": "image",
        "args": {}
      }
    ]
  },
  "path": "<string>",
  "revision": "<string>",
  "frameRevision": "<string>",
  "created": true,
  "diff": "<string>",
  "removed": [
    "<string>"
  ],
  "draftRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

Change part of a resource

Either text replacements in its code — [{ "old": "…", "new": "…" }], each old matching exactly once (code is stored formatted: copy old from what GET answered; 409 EDIT_NO_MATCH quotes the closest line) — or a JSON merge patch of its fields (application/merge-patch+json or JSON; null removes a field). One layer changes alone at its own path (frame/intro/title with { "props": { … } }). Checked like PUT.

PATCH

scenes

{id}

resources

{path}

Change part of a resource

curl --request PATCH \
  --url https://api.streamloop.app/v1/scenes/{id}/resources/{path} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  {
    "old": "<string>",
    "new": "<string>",
    "field": "<string>"
  }
]
'

import requests

url = "https://api.streamloop.app/v1/scenes/{id}/resources/{path}"

payload = [
    {
        "old": "<string>",
        "new": "<string>",
        "field": "<string>"
    }
]
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify([{old: '<string>', new: '<string>', field: '<string>'}])
};

fetch('https://api.streamloop.app/v1/scenes/{id}/resources/{path}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "summary": "<string>",
  "value": {
    "path": "<string>",
    "revision": "<string>",
    "code": "<string>",
    "name": "<string>",
    "description": "<string>",
    "transition": {
      "kind": "cut",
      "ms": 123
    },
    "sound": "<string>",
    "children": [
      {
        "path": "<string>",
        "description": "<string>",
        "as": "image",
        "args": {}
      }
    ]
  },
  "path": "<string>",
  "revision": "<string>",
  "frameRevision": "<string>",
  "created": true,
  "diff": "<string>",
  "removed": [
    "<string>"
  ],
  "draftRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "line": 123,
      "path": "<string>",
      "node": "<string>",
      "message": "<string>"
    }
  ],
  "currentRevision": "<string>"
}

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

If-Match

string

The revision (ETag) you read — one, or a comma-separated list of which any current one matches — compared strongly (a weak W/"…" tag never matches): refused with 412 PRECONDITION_FAILED if the resource changed since or no longer exists (the problem carries currentRevision, null when it is gone, and for a layer frameRevision: either is taken). A layer takes its own revision or that of the frame/<id> it is in. *: it must exist. Checked atomically with the write: of two writes sent at once with the same revision, one lands and the other is 412.

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

string

required

The scene's id (scn_…)

Pattern: ^scn_

path

string

required

A resource path, slashes and all: frame/intro, frame/intro/title, source/data/headlines/rows, component/LowerThird, script/show.ts, a type (element/Text) or a list (frame/*)

Body

object[]
object

old

string

required

new

string

required

field

string

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

Show child attributes

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

Get started

REST API

Scenes API

MCP server

GraphQL API

Change part of a resource

Authorizations

Headers

Path Parameters

Body

Response