Attach a File to a Project

Attach an already-uploaded file to a project. The file remains in its current folder; this only records the project link.

Requires a user-scoped API key (u:gcai_...) with write access to the project and read access to the file.

POST /projects/{id}/files

Attach a file to a project

cURL

curl --request POST \
  --url https://app.gc.ai/api/external/v1/projects/{id}/files \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

400

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

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 project ID

Body

application/json

file_id · string<uuid> · required

ID of an already-uploaded file to attach to the project

Response

204

File attached (idempotent, repeat calls are no-ops)