Files

Move a file

Move a file to a different folder by updating its folder_id. Org-scoped keys can move non-access-controlled files to non-access-controlled destination folders.

patch/files/{id}

Request

Base URL
https://app.gc.ai/api/external/v1
Auth
API key in header Authorization
TypeScript
https://skmtc.dev/gc-ai/apis/gc-ai-external-api/docs/files/:id/patch.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring uuid required

The file ID

Request body

folder_idstring uuid nullable required

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

Response

File moved successfully

idstring uuid required

Unique file identifier

namestring required

Original filename

sizenumber required

File size in bytes

content_typestring required

MIME type of the file

status'extracting' | 'embedding' | 'ready' | 'failed' required

Current processing status of the file

created_atstring required

ISO 8601 creation timestamp

folder_idstring uuid nullable

Folder the file belongs to

extraction_errorstring

Error message if extraction failed

project_idstring uuid

Project the file is linked to, if uploaded with project_id

warningstring

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

Example response

{
  "content_type": "application/pdf"
}

Changes

No recorded changes to this operation across all 1 revision of this API.