---
title: "The rs-intent/1 specification: every field, constant and formula."
method: GET
path: "/v1/intents/spec"
tags: ["Platform"]
---

# The rs-intent/1 specification: every field, constant and formula.

`GET /v1/intents/spec`

## Request

- Base URL: `https://www.rightshold.com`
- URL: `https://www.rightshold.com/v1/intents/spec`
- Auth: none required

## Headers

- `X-Request-Id` string

## Response `200`

OK

- object: Inferred from 2 recorded responses; required fields appeared in every one; additional properties may appear.
  - `spec` string, required
  - `token_type` string, required
  - `delegation_spec` string, required
  - `issuer` string, required
  - `page` string, required
  - `purposes` string[], required
  - `data_categories` string[], required
  - `outcomes` string[], required
  - `binding_levels` object[], required
    - `level` string, required
    - `name` string, required
    - `means` string, required
  - `mandate` object, required
    - `spec` string, required
    - `means` string, required
    - `document` string, required
    - `committed` string, required
  - `audience_tokens` object, required
    - `means` string, required
    - `verify` string, required
    - `observations` string, required
  - `intent_keys` object, required
    - `means` string, required
    - `limits` object, required
      - `keys_per_intent` integer, required
      - `operations` string, required
  - `proof_bundle` object, required
    - `spec` string, required
    - `means` string, required
  - `recorder` string, required
  - `limits` object, required
    - `intents_in_force_per_agent` integer, required
  - `states` object, required
    - `pending` string, required
    - `active` string, required
    - `expired` string, required
    - `revoked` string, required
    - `orphaned` string, required
    - `suspended` string, required
    - `rule` string, required
  - `keys` string, required
  - `statement` object, required
    - `fields` string[], required
    - `signature` string, required
    - `hash` string, required
  - `risk` object, required
    - `formula` string, required
    - `base` object, required
      - `research` integer, required
      - `monitoring` integer, required
      - `customer_support` integer, required
      - `content_generation` integer, required
      - `procurement` integer, required
      - `commerce` integer, required
      - `other` integer, required
      - `data_collection` integer, required
      - `model_training` integer, required
    - `classes` object, required
      - `R1` string, required
      - `R2` string, required
      - `R3` string, required
      - `R4` string, required
  - `chains` object, required
    - `max_depth` integer, required
    - `rules` string[], required
    - `delegation` string, required
  - `budgets` string, required
  - `conformance` object, required
    - `counted` string, required
    - `components` object, required
      - `scope` string, required
      - `window` string, required
      - `rate` string, required
      - `budget` string, required
      - `observations` string, required
    - `utilization` string, required
    - `token_lifetime_seconds` object, required
      - `R1` integer, required
      - `R2` integer, required
      - `R3` integer, required
      - `R4` integer, required
    - `estimator` string, required
    - `weights` object, required
      - `scope` number, required
      - `window` number, required
      - `rate` number, required
      - `budget` number, required
      - `observations` number, required
    - `aggregate` string, required
    - `bands` object, required
      - `A` number, required
      - `B` number, required
      - `C` number, required
      - `D` integer, required
    - `minimum_requests` integer, required
    - `freshness` string, required
    - `observer_weight` string, required
    - `networks` string, required
  - `http_signatures` object, required
    - `standard` string, required
    - `alg` string, required
    - `keyid` string, required
    - `must_cover` string[], required
    - `max_skew_seconds` integer, required
    - `key_directory` string, required
    - `verify` string, required
    - `web_bot_auth` object, required
      - `tag` string, required
      - `keyid` string, required
      - `must_cover` string[], required
      - `created_and_expires` string, required
      - `signature_agent` object, required
        - `jwks_uri` string, required
        - `cimd` string, required
        - `rightshold` string, required
      - `resolving` string, required
  - `endpoints` object, required
    - `declare` string, required
    - `sign` string, required
    - `token` string, required
    - `key` string, required
    - `mandate` string, required
    - `proof` string, required
    - `verify_proof` string, required
    - `revoke` string, required
    - `conformance` string, required
    - `verify` string, required
    - `observe` string, required
    - `agent_profile` string, required
  - `privacy` string, required

## Other responses

- `400`: Problem details: a stable error code, type URI, title, status and an explanation
- `401`: Problem details: a stable error code, type URI, title, status and an explanation
- `404`: Problem details: a stable error code, type URI, title, status and an explanation
- `405`: Problem details: a stable error code, type URI, title, status and an explanation
- `422`: Problem details: a stable error code, type URI, title, status and an explanation
- `429`: Request budget exhausted; retry after Retry-After seconds
- `500`: Problem details: a stable error code, type URI, title, status and an explanation
- `4XX`: {error, detail}

---

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