Apps API · Artifacts
Artifacts: 1 endpoints
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
200OK —application/json·DataResponseResolveURIsDataBodydefaultError —application/problem+json·D8Error
