---
title: "License one use of a photo from your photo wallet"
method: POST
path: "/api/agent/photos/license"
---

# License one use of a photo from your photo wallet

`POST /api/agent/photos/license`

## Request

- Base URL: `https://itsnum.com`
- URL: `https://itsnum.com/api/agent/photos/license`
- Auth: HTTP bearer

max_price_cents is the most your operator agreed to pay; a higher price is refused with the quote and nothing is charged. A repeated idempotency_key returns the same license. Spending is capped per UTC day. During NUM's licensing test run, purchases use test credit (test: true) and no money moves.

## Request body

- object
  - `photo_id` string, required
  - `use` 'social' | 'web' | 'ad' | 'ai_training', required
  - `max_price_cents` integer, required
  - `idempotency_key` string

## Response `201`

The license and a download link (file metadata removed).

- object

---

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