Apply session configuration
Initializes a new session or updates an existing session’s configuration at runtime, including its workflow definitions
Authorizations
API key sent as Authorization: Bearer <key>. Needed only when the server has a key configured.
Body
Request object for session configuration, supporting both initialization and runtime updates
The unique session identifier used to track this context
256^(?!.*\.\.)[^/\\]*$"session-123"
A human-readable name for the session
256"Production ETL v4"
A human-readable description of the session
256"Daily build and quality check"
The name of the initiator (user or system)
1"AI Agent"
The absolute root path of the project on the server's filesystem
1024"/home/user/workspace/project-alpha"
A map of workflow definition requests keyed by workflow ID
Metadata tags for categorization and filtering
Response
OK
Unified API response wrapper for both success and error responses. Success responses include data field; error responses include error, path, and errors fields.
The time the response was generated
The HTTP status code
200
A human-readable message
"Operation successful"
The response data
The HTTP status error name
"Bad Request"
The request path
"/api/files"
The list of field validation errors