Files

Add an external link

Adds an external link (Figma, Drive, Notion...) — no storage, no scan, no size limit. The URL's domain is validated against source_type. Requires operation files:write.

post/projects/{project_id}/files/link

Request

  • Base URL: https://app.fareeqy.com/api/v1
  • URL: https://app.fareeqy.com/api/v1/projects/{project_id}/files/link
  • Auth: HTTP bearer

Request body

namestring required
urlstring uri required
source_type'notion' | 'google_drive' | 'dropbox' | 'onedrive' | 'box' | 'figma' | 'sketch' | 'zoho' | 'other' required

The provider an external link points to (its domain is validated).

folder_idinteger nullable

Destination folder; omit for the project root.

Response

The created link.

Example response

{
  "data": {
    "id": 108,
    "url": "https://app.fareeqy.com/files/fil-3qd8n",
    "name": "الهوية-البصرية.pdf",
    "path": "التصاميم/الهوية-البصرية.pdf",
    "folder_id": 42,
    "content_type": "application/pdf",
    "size_bytes": 2418176,
    "size_human": "2.31 م.بايت",
    "external_url": null,
    "source": null,
    "scan_state": "clean",
    "downloadable": true,
    "uploaded_by": "سارة العتيبي",
    "created_at": "2026-07-10T16:31:44.000+03:00"
  }
}

Changes

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