---
title: "Resolve asset ids to URLs"
method: POST
path: "/assets/resolve"
tags: ["Assets"]
---

# Resolve asset ids to URLs

`POST /assets/resolve`

## Request

- Base URL: `https://app.flora.ai/api/v1`
- URL: `https://app.flora.ai/api/v1/assets/resolve`
- Auth: HTTP bearer

Resolves up to 100 asset ids to their media URLs in one call — the batch counterpart of GET /assets/{assetId} for callers holding many ids, such as the reference input ids generation history reports. Each entry echoes its requested id; an id that is missing, deleted or outside the caller's access resolves to url null with not_found true, matching the single-read's deliberate ambiguity. A malformed asset_id rejects the whole request.

## Request body

- object
  - `asset_ids` string[], required: Asset ids (asset_…) to resolve, up to 100 per call

## Response `200`

Assets resolved.

- object
  - `results` object[], required: One entry per requested asset id, in request order
    - `asset_id` string, required: The id from the request, echoed
    - `url` string, nullable, required: The asset's media URL, or null when nothing readable answered to the id — a missing, deleted or inaccessible asset resolves the same way by design
    - `not_found` boolean, required: True when the id resolved to nothing readable

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `403`: 403
- `404`: 404
- `409`: 409
- `429`: 429
- `500`: 500
- `503`: 503

## Changes

- **2026-10-28** `a8351619f225`: 9 warning
  - added the new `not_configured` enum value to the `error/code` response property for the response status `400`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `401`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `402`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `403`
  - …5 more
- **2026-10-16** `e54130373b10`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/changes/assets/resolve/post.md)

---

[API](https://skmtc.dev/florafauna-ai/apis/flora-ai-api.md) - [All operations](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/revisions/87cfe2c4ac29?raw)