ConnectCloud Developers

Download a file of an item (tenant:forge:read)

GET /api/forge/v1/projects/{key}/items/{number}/attachments/{id}

Module: Forge · operationId: downloadForgeItemAttachment · Tag: Attachments · Auth: access token (Authorization: Bearer <accessToken>)

Requires tenant:forge:read and an item the caller sees. Only files DMS' malware scan found clean are served; infected or unscanned files are 403 (infected, not_scanned), a running scan 409 scan_pending. 503 when DMS is not configured.

Parameters

Name In Type Required Description
key path string yes Project key (e.g. APP)
number path integer yes Item number in the project (12 of APP-12)
id path string (uuid) yes

Responses

  • 200 The file (application/octet-stream)
  • 403 Error (application/json)
  • 404 Error (application/json)
  • 409 Error (application/json)
  • 503 Error (application/json)

Example request

curl -X GET 'https://api.mbcom.cloud/api/forge/v1/projects/string/items/1/attachments/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI