Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.lensmor.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Agent file detail

Resolve a generated file resource into metadata and a temporary download URL. Use this endpoint when you have a lensmor-file://{fileUuid} resource link and need file metadata plus a signed URL to download the content.

​
Endpoint

GET /external/agent-files/:id

​
Authentication

See Authentication

​
Success status code

200 OK

​
Path parameters

NameRequiredTypeNotes
idYesstringFile UUID from a lensmor-file://{fileUuid} resource link.

​
Response body

FieldTypeNotes
fileIdstringFile UUID.
namestringOriginal file name.
mimeTypestringMIME type for the file.
sizeBytesinteger or nullUploaded file size in bytes when known.
signUrlstringTemporary download URL.

​
Response example

{
  "fileId": "550e8400-e29b-41d4-a716-446655440000",
  "name": "report.csv",
  "mimeType": "text/csv",
  "sizeBytes": 10240,
  "signUrl": "https://storage.example.com/uploads/550e8400-e29b-41d4-a716-446655440000_report.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600"
}

​
Error responses

  • 400 Bad Request when id is empty.
  • 401 Unauthorized when the API key is missing, malformed, or invalid.
  • 403 Forbidden when the file exists but belongs to another user.
  • 404 Not Found when the file cannot be resolved.

​
Notes

  • Only uploaded, non-deleted files can be resolved.
  • :id is a file UUID, not the numeric file record identifier returned by Agent files upload presign.
  • Download URLs expire after 1 hour.