---
title: "Report compact capability outcomes or stage; requires read + requests:write"
method: POST
path: "/api/v1/sessions/{id}/events"
tags: ["Task sessions"]
---

# Report compact capability outcomes or stage; requires read + requests:write

`POST /api/v1/sessions/{id}/events`

## Request

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

## Path parameters

- `id` string, required

## Request body

- object
  - `request_id` string, required
  - `type` 'viewed' | 'called' | 'succeeded' | 'failed' | 'skipped' | 'stage', required
  - `capability` string
  - `summary` string
  - `current_stage` string
  - `reported_tool_turns` integer
  - `reported_cost_usd` number

## 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)