---
title: "Close with client-reported outcome; requires read + requests:write"
method: POST
path: "/api/v1/sessions/{id}/close"
tags: ["Task sessions"]
---

# Close with client-reported outcome; requires read + requests:write

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

## Request

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

## Path parameters

- `id` string, required

## Request body

- object
  - `request_id` string, required
  - `outcome` 'completed' | 'abandoned' | 'failed', required
  - `summary` 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)