POST /session
Register a reusable session playbook (cookies, headers, tags).
POST
Register a session playbook
Register or replace a login playbook (site URL + ordered browser actions) for a session.
The orchestrator can replay this playbook automatically when it detects expired cookies.
Request parameters (JSON body)
Required
site(string): Login/start URL for the site you want to authenticate against.actions(array, min 1): Ordered browser interactions to perform onsite.
Action object
action(string, required):click,type,scroll,wait,selectselector(string | null): Element selector (if applicable)selector_type(string, default:css):css,xpath,role,text,regex,test_id,label,placeholdervalue(string | null): Input text / scroll amount / wait ms (depends on action)
Optional
session_id(string | null): Provide to update/replace an existing playbook. If omitted, a new random ID is generated and returned.
Responses
- 200: The stored playbook echoed back with its assigned
session_id. - 422: Validation error (invalid
siteURL or emptyactionslist).
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Register or replace a session playbook (login URL + actions) for automatic replay after cookie clears.
