Get a source file (metadata + signed download URL)

GET

/api/v1/files/{fileId}

curl --request GET \
  --url https://api.langparse.dev/api/v1/files/example \
  --header 'X-Api-Key: <X-Api-Key>'

The fileId is the id of a folder-listing item (or a document’s file). Returns file metadata and a short-lived presigned S3 download URL (attachment, ~15 min). Request on demand; do not cache the URL.

Authorizations

• apiKey
• bearerAuth

Parameters

Path Parameters

fileId

required

string

Responses

200

File metadata + signed download URL

Media typeapplication/json

object

id

string

fileName

string

byteSize

integer

nullable

pageCount

integer

nullable

contentType

string

nullable

url

Presigned S3 GET (attachment). Expires per expiresInSeconds.

string

expiresInSeconds

integer

Example^generated

{
  "id": "example",
  "fileName": "example",
  "byteSize": 1,
  "pageCount": 1,
  "contentType": "example",
  "url": "example",
  "expiresInSeconds": 1
}

401

Missing or invalid API key

404

File not found