Skip to main content
PUT

Overview

Files one scenario in a folder. If the scenario is already in a folder, it moves to the new one. Set folder_id to null to take it out of its folder. Taking out a scenario that isn’t filed still succeeds. Create the folder first with Create Folder. For how folders work, see List Scenario Folders. Requires an admin, owner, operator, or prompter role. Restricted API keys can’t call this endpoint. Use a full-access key.

Headers

string
required
Your API key for authentication.

Body Parameters

string
required
The agent the scenario belongs to. Returns 404 NOT_FOUND if the agent isn’t in your organization or has been deleted.
string
required
The scenario’s node ID: the id of a scenario from List Library Scenarios. 1 to 200 characters. Bland doesn’t check that the agent has a node with this ID, so check it before you send it.
string | null
required
The folder to file the scenario in, or null to take it out of its folder. Returns 404 NOT_FOUND if the folder isn’t in your organization.
A missing field, an agent_id or folder_id that isn’t a UUID, or a node_id outside 1 to 200 characters returns 400 BAD_REQUEST.

Response

object
The saved filing.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt