---
title: "Progressive or full capability selection. Charges the published resolve price (/api/v1/pricing) when billing is on and needs a key with read + requests:write; data.economics reports chargedCredits and creditsRemaining. For an intent, each result has match (exact, strong or weak) and confidence (share of the intent's specific terms matched, 0 to 1); data.match_quality is strong, no_strong_match or none, with a message when nothing strong fits. session_id also requires request_id"
method: POST
path: "/api/v1/capabilities/resolve"
tags: ["Task sessions"]
---

# Progressive or full capability selection. Charges the published resolve price (/api/v1/pricing) when billing is on and needs a key with read + requests:write; data.economics reports chargedCredits and creditsRemaining. For an intent, each result has match (exact, strong or weak) and confidence (share of the intent's specific terms matched, 0 to 1); data.match_quality is strong, no_strong_match or none, with a message when nothing strong fits. session_id also requires request_id

`POST /api/v1/capabilities/resolve`

## Request

- Base URL: `https://api.daystruct.ai`
- URL: `https://api.daystruct.ai/api/v1/capabilities/resolve`
- Auth: one of:
  - none
  - HTTP bearer

## Request body

- object
  - `session_id` string
  - `request_id` string
  - `intent` string
  - `capabilities` string[]
  - `bundle_id` string
  - `delivery` 'progressive' | 'full'
  - `limit` integer
  - `include_repeat` boolean
  - `include_considered` boolean: Return every considered reference. By default the response carries considered_count, at most 5 deferred entries and deferred_count.
  - `maxPriceCredits` integer: Optional. The most this call may charge, in credits. Without it, only the API key limit applies (none unless the account owner set one). The price is in /api/v1/pricing.

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