---
title: "Create Resource Document"
method: POST
path: "/v1/resources/resource/{resource_id}/documents"
tags: ["API / Resource", "Use case / Master data sync"]
---

# Create Resource Document

`POST /v1/resources/resource/{resource_id}/documents`

## Request

- Base URL: `https://api.qargo.com`
- URL: `https://api.qargo.com/v1/resources/resource/{resource_id}/documents`
- Auth: OAuth 2 (client credentials, token URL `/v1/auth/token`)

Attach an uploaded document to a resource without a validity. Upload the file through the document upload endpoint first and pass the returned `upload_id`.

## Path parameters

- `resource_id` string, uuid, required

## Request body

- UploadedResourceDocument
  - `upload_id` string, uuid, required: Unique identifier of the uploaded file
  - `document_type` union, required: Type of the document
    - 'COMMUNICATION_SUBCONTRACTOR' | 'CONTAINER_CERTIFICATE' | 'CONTAINER_DAMAGE_REPORT' | 'CONTAINER_INSPECTION_REPORT' | 'CONTAINER_LEASE' | 'CONTAINER_MAINTENANCE_REPORT' | 'CONTAINER_REPAIR_REPORT' | 'CONTAINER_TANK_TEST_CERTIFICATE_2Y5' | 'CONTAINER_TANK_TEST_CERTIFICATE_5Y' | 'CONTAINER_TANK_TEST_CERTIFICATE'
    - 'A1_DOCUMENT' | 'CARGO_INSURANCE' | 'BBS_CERTIFICATE' | 'COMMUNICATION_SUBCONTRACTOR' | 'DOMESTIC_CARGO_INSURANCE' | 'DRIVER_ADR_LICENSE' | 'DRIVER_AEO_REGULATED_AGENT_LICENSE' | 'DRIVER_ALFAPASS' | 'DRIVER_CARD' | 'DRIVER_CARGOCARD_ACCESS_CARD' | 'DRIVER_CIVIL_LIABILITY_EXPLOITATION' | 'DRIVER_CIVIL_LIABILITY_INSURANCE' | 'DRIVER_CODE_95' | 'DRIVER_CPC_CARD' | 'DRIVER_DRIVING_LICENSE' | 'DRIVER_IDENTITY_CARD' | 'DRIVER_IMI_PORTAL' | 'DRIVER_INSURANCE' | 'DRIVER_LONG_HEAVY_VEHICLE_CERT' | 'DRIVER_MEDICAL_EXAM' | 'DRIVER_PERSONAL_PROTECTIVE_EQUIPMENT' | 'DRIVER_POSTING_DOCUMENT' | 'DRIVER_REFUGEE_TRAINING_LICENSE' | 'DRIVER_SICK_NOTE' | 'DRIVER_TRAINING' | 'EUROVIGNET' | 'EXCEPTIONAL_TRANSPORT_LICENSE' | 'FINE' | 'FORKLIFT_LICENSE' | 'FUEL_CARD' | 'OTHER' | 'PAYSCALE_DRIVER' | 'SAFETY_CERTIFICATE_TERMINAL' | 'SITE_MOVEMENT_SHEET' | 'TOLL_CARD' | 'VCA_BASIC_SAFETY' | 'VEHICLE_ADR_CERTIFICATE'
    - 'BRAKE_TEST_CERTIFICATE' | 'CERTIFICATE_OF_CONFORMITY' | 'CITERNE_CLEANING_CERTIFICATE' | 'COMMUNICATION_SUBCONTRACTOR' | 'CONTAINER_TANK_TEST_CERTIFICATE_2Y5' | 'CONTAINER_TANK_TEST_CERTIFICATE_5Y' | 'CONTAINER_TANK_TEST_CERTIFICATE' | 'EUROVIGNET' | 'EXCEPTIONAL_TRANSPORT_LICENSE' | 'FINE' | 'FUEL_CARD' | 'HEAVY_LOAD_BE' | 'HEAVY_LOAD_DE' | 'HEAVY_LOAD_FR' | 'OTHER' | 'OVERSIZE_WL_PERMIT' | 'ROADTAX' | 'TOLL_CARD' | 'VEHICLE_12_WEEKLY_CHECK' | 'VEHICLE_ADR_CERTIFICATE' | 'VEHICLE_ATP_CERTIFICATE' | 'VEHICLE_DAMAGE_REPORT' | 'VEHICLE_FIRE_EXTINGUISHER_SERVICE' | 'VEHICLE_FRC_CERTIFICATE' | 'VEHICLE_FRIDGE_MOTOR' | 'VEHICLE_GERMAN_SECURITY_INSPECTION' | 'VEHICLE_GERMAN_VEHICLE_INSPECTION' | 'VEHICLE_IDENTIFICATION_REPORT' | 'VEHICLE_INSURANCE_CERTIFICATE' | 'VEHICLE_MAINTENANCE_REPORT' | 'VEHICLE_MOT_TEST' | 'VEHICLE_REGISTRATION' | 'VEHICLE_REPAIR_REPORT' | 'VEHICLE_TACHO' | 'VEHICLE_TIR' | 'VEHICLE_TRANSPORT_LICENSE' | 'VEHICLE_UK_HGV_LEVY' | 'XL_CERTIFICATE'
  - `name` string, required: Name of the document

## Response `200`

Successful Response

- Document
  - `id` string, uuid, required: Unique identifier of the document
  - `name` string, required: Name of the document
  - `type` string, required: Type of the document
  - `download_url` string: Relative URL from the base URL to download the document
  - `subject_type` string, required: Linked subject of the document
  - `content_type` string, nullable: Content type of the document

## Other responses

- `400`: Bad Request — invalid input or malformed request
- `401`: Unauthorized — missing or invalid authentication credentials
- `403`: Forbidden — insufficient permissions for this operation
- `422`: Validation Error
- `429`: Too Many Requests — rate limit exceeded. See the `Retry-After` header
- `500`: Internal Server Error
- `503`: Service Unavailable — temporarily unable to handle the request

## Changes

- **2026-10-06** `1f913023231c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qargo/apis/qargo-tms-api/changes/v1/resources/resource/:resource_id/documents/post.md)

---

[API](https://skmtc.dev/qargo/apis/qargo-tms-api.md) · [All operations](https://skmtc.dev/qargo/apis/qargo-tms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qargo/apis/qargo-tms-api/revisions/46db2c329351?raw)