OpenMax
Free Trial

Apps API · Artifacts

Artifacts: 1 endpoints

← All groups

POST /api/v1/artifacts/resolve

Resolve artifact URIs

Scope: kb:artifact:read · Called with: appToken · operationId: resolve-uris

Required app scope: kb:artifact:read.

Batch-resolve artifact:// URIs to presigned download URLs. Use inline=false for download disposition. A URI is resolved only when the caller may read its artifact: a conversation file requires that the caller uploaded it or can read a conversation it was shared in; a knowledge-base file requires that the caller can read a node that holds it (a private knowledge base only for its owner and the owner's Agents, a restricted Default knowledge-base node only for those it admits). Either domain admitting the caller is enough; an artifact neither domain manages keeps the organization check. Any other URI (unreadable conversation or knowledge-base file, malformed URI, an artifact ID that is not a UUID, or a file name with an empty, "." or ".." segment, a backslash or a control character, another organization's artifact, or a caller without a member identity) is listed in failed, and no URL is issued for it; failed is de-duplicated and keeps the request order. When read access cannot be verified the whole request fails with 503 ARTIFACT_ACCESS_UNAVAILABLE and nothing is signed. When download tickets are enabled, download_url is a short-lived platform URL (download-artifact-ticket) instead of a storage URL and expires_at is the ticket expiry: single-use for inline=false, reusable until expiry for inline=true; access is re-checked when it is opened. Response wrapped in standard envelope.

Request body

application/json · ResolveURIsRequestBody

Field Type Required Description
inline boolean If true, return inline content-disposition URLs
uris array of string yes List of artifact:// URIs to resolve

Responses