Download a file
Download the raw bytes of a project file.
API 2.7.0 · Published service contract ↗
Request
Base URL: https://app.sym.so/v1/workspaces/{workspace_id}
Authentication: bearer. Required scope: files:read.
GET /agents/{agent_id}/files/download
Download the raw bytes of a project file.
| Parameter | Type | Description |
|---|---|---|
agent_idpath · required | string | Authorized Agent ID. |
pathquery · required | string | Relative file path. |
curl --fail-with-body -X GET "https://app.sym.so/v1/workspaces/$WORKSPACE_ID/agents/$AGENT_ID/files/download?path=$SYM_QUERY_PATH_URLENCODED" \
-H "Authorization: Bearer $SYM_WORKSPACE_API_KEY""Binary file bytes. Content-Disposition contains the safe project filename."Authorization
{
"type": "bearer",
"scope": "files:read",
"transport": "Authorization: Bearer <workspace_api_key>"
}Errors
| Status | Description |
|---|---|
| 401 | The workspace API key is missing, invalid, expired, or revoked. |
| 403 | The key lacks the required scope or its owner no longer has permission. |
| 404 | The resource is missing or intentionally hidden by authorization. |
| 429 | The key exceeded its current rate limit. |