Skip to main content
Create a new workflow session. A new session starts with status: "open" and is immediately writable — see Session Lifecycle for the statuses it can move through afterwards.

POST /revisions/:id/data/command (Command: create_session)

Request Body

See Alias Grammar for the character rules, length limits, the id-shape restriction, and which commands accept an alias in place of an id.

Response

The command raises session.created on the new session’s stream, with the alias in its session block when the session has one. See Types.

Errors

Example