Adds existing team assets to a session so they appear in it in the web app. Membership only: where an asset was created (Asset.sessionId) does not change. Already-member, deleted, and unknown ids are skipped. Free.
Authorization
bearerAuth processes:writeIn: header
Scope: processes:write
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/sessions/string/assets" \ -H "Content-Type: application/json" \ -d '{ "assetIds": [ "string" ] }'{ "sessionId": "string", "addedAssetIds": [ "string" ]}{ "error": { "code": "string", "message": "string", "requestId": "string" }}{ "error": { "code": "string", "message": "string", "requestId": "string" }}{ "error": { "code": "string", "message": "string", "requestId": "string" }}{ "error": { "code": "string", "message": "string", "requestId": "string" }}{ "error": { "code": "string", "message": "string", "requestId": "string" }}Add canvas cards POST
Adds 1-50 cards in one request, already wired. Give a card a ref and later cards in the same request can wire from it with inputs: [{ sourceRef }]; sourceNodeId wires from a card already on the canvas. A wire without port goes to the first free port that takes the source's type (text into prompt, images into references); wires are checked like a drag in the app: matching types, room in the port for the card's model, and no loops. Cards without a position are laid out left to right after the existing cards. Media cards take an assetId of their type and add that asset to the session. Generation cards default to the web app's default model and settings; modelId comes from GET /models for image-gen and video-gen and from textModels in GET /canvas for text-gen, and settings are checked against that model (video settings snap to the model's nearest supported values, as in the app). A field that does not apply to the card's kind is rejected. Shows up live on the canvas in the Yapper web app. Free. Uses the processes:write scope.
Cancel queued canvas cards POST
Takes cards that have not started out of a running canvas run: nodeIds plus the run's cards behind them, or every waiting card when nodeIds is omitted. A card whose generation has started cannot be cancelled, and nothing is charged for a card that never starts. conflict when nothing could be cancelled. Uses the processes:write scope.