Skip to main content
PATCH
Move a file

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

Body

application/json
folder_id
string<uuid> | null
required

Target folder ID to move the file to. Pass null to move to the root.

Response

File moved successfully

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