Skip to main content

List Artifacts

Returns all artifacts in a dock, ordered by createdAt descending.
GET /v1/docks/:dockId/artifacts

Path Parameters

ParameterTypeDescription
dockIdstringThe dock ID

Example Request

curl https://api.docyard.io/v1/docks/dock_01HQ3K.../artifacts \
  -H "Authorization: Bearer dk_live_a1b2c3d4..."

Response

[
  {
    "id": "art_01HQ3M...",
    "filename": "declaration-page-2025.pdf",
    "contentType": "application/pdf",
    "size": 245760,
    "hash": "sha256:a3f8c2d1...",
    "storageKey": "docks/dock_01HQ3K.../artifacts/f7a2b3c4.pdf",
    "metadata": {
      "policy_number": "POL-2025-4821",
      "document_type": "declaration-page"
    },
    "createdAt": "2025-01-15T10:31:00.000Z"
  },
  {
    "id": "art_01HQ3N...",
    "filename": "coi-renewal-q4.pdf",
    "contentType": "application/pdf",
    "size": 189440,
    "hash": "sha256:b7d2e4f5...",
    "storageKey": "docks/dock_01HQ3K.../artifacts/c8d9e1f2.pdf",
    "metadata": {},
    "createdAt": "2025-01-14T08:00:00.000Z"
  }
]

Error Handling

StatusCondition
401Missing or invalid API key
404Dock not found