---
title: "Mark a Right Token as used (own organization only)"
method: POST
path: "/api/rightos/tokens/{tokenId}/use"
tags: ["tokens"]
---

# Mark a Right Token as used (own organization only)

`POST /api/rightos/tokens/{tokenId}/use`

## Request

- Base URL: `https://rightos.i-s3.com`
- URL: `https://rightos.i-s3.com/api/rightos/tokens/{tokenId}/use`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-rightos-key`

## Path parameters

- `tokenId` string, required

## Response `200`

Updated token

## Other responses

- `401`: Missing or invalid API key (error: missing_api_key | invalid_api_key)
- `403`: Token belongs to another organization

---

[API](https://skmtc.dev/i-s3/apis/rightos-right-api.md) · [All operations](https://skmtc.dev/i-s3/apis/rightos-right-api/llms.txt) · [OpenAPI document](https://skmtc.dev/i-s3/apis/rightos-right-api/revisions/10020536e345?raw)