> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gc.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Attach files to project

> Link existing files to a project.

<Info>
  **Tool** `attach_to_project` · **Behavior** Additive
</Info>

Link existing files to a project. Membership is a separate edge, not a field on the project. Idempotent: re-linking a file is a no-op. Files you cannot access are reported in `not_found` and skipped; the rest are linked.

## Input parameters

<ParamField body="project_id" type="string (uuid)" required>
  Project to link the files to. You must have edit access.
</ParamField>

<ParamField body="file_ids" type="string (uuid)[]" required>
  File ids to link to the project (1-50).
</ParamField>

## Response

<ResponseField name="project_id" type="string (uuid)" />

<ResponseField name="attached" type="string (uuid)[]">
  Files now linked to the project (includes already-linked).
</ResponseField>

<ResponseField name="not_found" type="string (uuid)[]">
  Requested files that were not found or not accessible.
</ResponseField>