---
title: "Assess a resource for an intended use"
method: POST
path: "/v1/assessments"
tags: ["Rights desk"]
---

# Assess a resource for an intended use

`POST /v1/assessments`

## Request

- Base URL: `https://www.rightshold.com`
- URL: `https://www.rightshold.com/v1/assessments`
- Auth: one of:
  - none
  - HTTP bearer

## Headers

- `X-Request-Id` string

## Request body

- object
  - `principal_id` string
  - `workspace_id` string
  - `resource_id` string, required
  - `offer_id` string, nullable
  - `intended_use` IntendedUse: Unknown fields, non-boolean flags, duration_days outside 1-36500 or an empty geography are refused with 422 invalid_intended_use. The license check endpoints also require at least one use flag set to true.
    - `commercial_use` boolean
    - `redistribution` boolean
    - `modification` boolean
    - `sublicensing` boolean
    - `deployment` boolean
    - `attribution_planned` boolean
    - `geography` string
    - `duration_days` integer, nullable
    - `model_training` boolean
    - `model_inference` boolean

## Response `200`

OK

- object: Inferred from 17 recorded responses; required fields appeared in every one; additional properties may appear.
  - `assessment` object, required
    - `id` string, required
    - `schema_version` string, required
    - `principal_id` string, required
    - `workspace_id` string, required
    - `intended_use` object, required
      - `commercial_use` boolean, required
      - `redistribution` boolean, required
      - `modification` boolean, required
      - `sublicensing` boolean, required
      - `deployment` boolean, required
      - `attribution_planned` boolean, required
      - `geography` string, required
      - `duration_days` integer, nullable, required
      - `model_training` boolean, required
      - `model_inference` boolean, required
    - `intended_use_hash` string, required
    - `resource_id` string, required
    - `resource_version_id` string, required
    - `offer_id` unknown, required
    - `offer_version` unknown, required
    - `controlling_terms_hash` string, required
    - `controlling_terms_id` string, required
    - `policy_version` string, required
    - `evidence_snapshot` string[], required
    - `evaluated_at` string, required
    - `expires_at` string, required
    - `evaluator` object, required
      - `id` string, required
      - `method` string, required
    - `disposition` string, required
    - `findings` object[], required
      - `code` string, required
      - `explanation` string, required
      - `evidence_ids` string[], required
    - `unresolved_questions` string[], required
    - `required_approvals` unknown[], required
      - unknown
    - `next_actions` string[], required
    - `limitations` string[], required
    - `cost_evidence` object, required
      - `amount_cents` unknown, required
      - `currency` string, required
      - `source` string, required
    - `existing_entitlement_id` string, nullable, required
  - `explanation` object, required
    - `disposition` string, required
    - `label` string, required
    - `headline` string, required
    - `summary` string, required
    - `uses_evaluated` string[], required
    - `prohibited_uses` string[], required
    - `undocumented_uses` unknown[], required
      - unknown
    - `duties` 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

---

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