Retrieve outputs
Output URLs are signed and expire. Store stable output identities when permitted, then request a fresh access URL instead of treating an old signed URL as permanent.
By trace
Section titled “By trace”GET /v1/orgs/:orgId/outputs/by-trace/:traceIdx-license-key: <server-secret>Use this when retrieving outputs for one known execution trace.
By entity
Section titled “By entity”GET /v1/orgs/:orgId/outputs/by-entity/:entityId?limit=50x-license-key: <server-secret>Use this for permitted recent history associated with an application entity.
Safe handling
Section titled “Safe handling”- Do not log signed URLs.
- Do not expose license keys while proxying outputs to a browser.
- Respect storage policy and deleted or unavailable states.
- Treat content type returned by the output contract as authoritative; do not force every result to PNG or JPEG.
Prepared media is not output history
Section titled “Prepared media is not output history”Prepared-image caching reuses intermediate preparation, not final results. A preparedMedia cache hit does not guarantee that a final output was retained. Under no_store, consume the permitted initial response rather than assuming later retrieval will recover its image. Respect retention and deletion independently of preparation reuse.