Retrieve File - Perceptron Docs

Retrieve a file

curl --request GET \
  --url https://api.perceptron.inc/v1/files/{file_id} \
  --header 'Authorization: Bearer <token>'

{
  "bytes": 123,
  "created_at": 123,
  "filename": "<string>",
  "id": "<string>",
  "object": "<string>"
}

GET

files

{file_id}

Retrieve a file

curl --request GET \
  --url https://api.perceptron.inc/v1/files/{file_id} \
  --header 'Authorization: Bearer <token>'

{
  "bytes": 123,
  "created_at": 123,
  "filename": "<string>",
  "id": "<string>",
  "object": "<string>"
}

Return metadata (size, filename, purpose, creation time) for one file. For the bytes, use Retrieve File Content. Compatible with OpenAI’s Retrieve file endpoint. Rate limit: 100 requests/min.

Authorization

string

header

required

Bearer token authentication using your Perceptron API key

file_id

string

required

The id of the file to retrieve.

File metadata.

bytes

integer<int64>

required

File size in bytes.

created_at

integer<int64>

required

Unix timestamp (seconds) when the file was created.

filename

string

required

Original file name.

string

required

File ID, e.g. file-abc123.

object

string

required

Always "file".

purpose

enum<string>

required

File purpose.

Available options:

vision,

user_data