> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blobhub.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Session

Create a new workflow session.

## **POST** `/revisions/:id/data/command` (Command: `create_session`)

### Request Body

| Parameter     | Type   | Required | Description                                         |
| :------------ | :----- | :------- | :-------------------------------------------------- |
| `engine`      | string | Yes      | Must be `workflow_blobhub`.                         |
| `command`     | string | Yes      | Must be `create_session`.                           |
| `description` | string | No       | Optional description.                               |
| `tracing`     | object | No       | Tracing configuration (e.g., `{"log_data": true}`). |

### Response

| Parameter | Type   | Description                 |
| :-------- | :----- | :-------------------------- |
| `session` | object | The created session object. |

### Example

<CodeGroup>
  ```json Request theme={null}
  {
    "engine": "workflow_blobhub",
    "command": "create_session",
    "description": "Production Run 1",
    "tracing": { "log_data": true }
  }
  ```

  ```json Response theme={null}
  {
    "session": {
      "id": "sess_001",
      "status": "open"
    }
  }
  ```
</CodeGroup>