---
title: "Set one asset's approval state."
method: PATCH
path: "/organizations/{organizationId}/libraries/{libraryId}/assets/{assetId}/approval"
tags: ["Assets"]
---

# Set one asset's approval state.

`PATCH /organizations/{organizationId}/libraries/{libraryId}/assets/{assetId}/approval`

## Request

- Base URL: `https://api.raster.app`
- URL: `https://api.raster.app/organizations/{organizationId}/libraries/{libraryId}/assets/{assetId}/approval`
- Auth: HTTP bearer

Sets the asset's approval to one of the organization's approval states, with an optional note; each call replaces the previous approval. Works on an original or a variant. Needs an OAuth access token — an API key can read approval but not set it (403 APPROVAL_REQUIRES_USER). Setting approval needs a paid plan (403 PAID_PLAN_REQUIRED).

## Path parameters

- `organizationId` string, required
- `libraryId` string, required
- `assetId` string, required

## Headers

- `Api-Version` string, required

## Request body

- object
  - `state` string, required
  - `note` string, nullable

## Response `200`

OK

- object
  - `data` object, required
    - `assetId` string, required
    - `approval` object, required
      - `state` string, required
      - `setBy` string, nullable, required: Email address of the person who set the approval. `null` when their account has no email address.
      - `setAt` number, required
      - `note` string

## Other responses

- `400`: Invalid input (BAD_USER_INPUT), quota, or API-version error.
- `401`: Missing or invalid API key or access token.
- `403`: The credential may not perform this operation, or the organization's plan does not allow it. A key without access to a library gets 404, not 403.
- `404`: Resource not found, or the credential is not authorized for it.
- `429`: Rate limit exceeded. Wait for the number of seconds in `Retry-After` before retrying.
- `500`: Unexpected server fault (INTERNAL_SERVER_ERROR). Safe to retry an idempotent operation.

---

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