---
title: "Store a reference image/video — embedded into your private vector namespace for useReferences retrieval"
method: POST
path: "/v1/agent/references"
---

# Store a reference image/video — embedded into your private vector namespace for useReferences retrieval

`POST /v1/agent/references`

## Request

- Base URL: `https://livepairai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://livepairai.com/v1/agent/references`
- Auth: none declared

## Request body

- object
  - `media` string, required: data:image|video URI, or a public https URL
  - `label` string: optional caption (≤200 chars)

## Response `201`

{ ok, asset } — vectorReady=1 means semantically searchable

## Other responses

- `400`: Missing/oversized media (image ≤8MB, video ≤40MB)
- `415`: Only image/* or video/* references
- `422`: Vision policy rejection
- `429`: Library full (100 per owner) or rate limited

---

[API](https://skmtc.dev/livepairai/apis/private-ai-media-generation-api.md) · [All operations](https://skmtc.dev/livepairai/apis/private-ai-media-generation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livepairai/apis/private-ai-media-generation-api/revisions/84e74cdf1dbd?raw)