Skip to main content
GET
Get a signed URL for a file asset
Generate a fresh signed URL for a specific asset attached to a case file. Use this endpoint when you need a short-lived URL for a single asset without fetching the full analysis response.

Permission

You can get assets for a file you uploaded, or for any file in your organisation if you have organisation_files:read; otherwise the API returns 404. Shared cases, if enabled for your organisation, also give you reach to every case and file. See Permissions and API Keys.

Supported Assets

URL Expiration

Signed URLs expire 30 minutes after generation. Do not store them — call this endpoint again to get a fresh URL when needed.

Best Practices

  1. Request on demand: Fetch a signed URL immediately before you need to use it. Storing URLs risks serving expired links to your users.
  2. Check asset availability: A 404 with code request.cases.case-file.asset-not-found means the asset has not been generated yet or doesn’t exist for the file. Wait for the file’s analysis_status to reach settled before requesting report or overlay assets.
  3. Security: Never expose signed URLs in client-side code or public environments.

Authorizations

x-api-key
string
header
required

Query Parameters

file_id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
asset
enum<string>
required
Available options:
file_download,
thumbnail,
pdf_report,
log_output,
ela_overlay

Response

Signed URL generated

url
string<uri>
required
expires_at
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$