---
title: "Create optional compact task context; requires read + requests:write"
method: POST
path: "/api/v1/sessions"
tags: ["Task sessions"]
---

# Create optional compact task context; requires read + requests:write

`POST /api/v1/sessions`

## Request

- Base URL: `https://api.daystruct.ai`
- URL: `https://api.daystruct.ai/api/v1/sessions`
- Auth: HTTP bearer

## Request body

- object
  - `request_id` string, required
  - `intent` string, required
  - `current_stage` string
  - `steps` object[]
    - `id` string, required
    - `capability` string, required
    - `depends_on` string[]

## Response `200`

Task context or selected capability descriptors in a data envelope

## Other responses

- `400`: Invalid contract
- `401`: API key required
- `403`: Missing read or requests:write scope
- `404`: Unavailable resource or another principal session
- `409`: Idempotency conflict, expired session or invalid progression
- `429`: Bounded session/event limit reached

---

[API](https://skmtc.dev/daystruct/apis/daystruct-api.md) · [All operations](https://skmtc.dev/daystruct/apis/daystruct-api/llms.txt) · [OpenAPI document](https://skmtc.dev/daystruct/apis/daystruct-api/revisions/8cd3c7f60e18?raw)