Skip to main content
GET
Get file status

Authorizations

Authorization
string
header
required

API key for authentication. Format: gcai_xxxxxxxxx

Create API keys in the GC AI app under Settings → API.

Path Parameters

id
string<uuid>
required

The file ID

Response

File metadata and status

id
string<uuid>
required

Unique file identifier

name
string
required

Original filename

size
number
required

File size in bytes

content_type
string
required

MIME type of the file

Example:

"application/pdf"

status
enum<string>
required

Current processing status of the file

Available options:
extracting,
embedding,
ready,
failed
created_at
string
required

ISO 8601 creation timestamp

folder_id
string<uuid> | null

Folder the file belongs to

extraction_error
string

Error message if extraction failed

project_id
string<uuid>

Project the file is linked to, if uploaded with project_id

warning
string

Present when the file was uploaded successfully but a secondary operation (e.g. project linking) failed