curl --request POST \
  --url https://api.poelis.com/v1/public/files/{target_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=<string>'

import requests

url = "https://api.poelis.com/v1/public/files/{target_id}"

payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"\r\n\r\n<string>\r\n-----011000010111000001101001--"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "multipart/form-data"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const form = new FormData();
form.append('file', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.poelis.com/v1/public/files/{target_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "content_type": "application/pdf",
  "deleted": false,
  "description": "Specification document for compressor performance and operating constraints.",
  "id": "990e8400-e29b-41d4-a716-446655440000",
  "name": "compressor-spec-v3.pdf",
  "originalFileName": "compressor-spec-v3.pdf",
  "size_bytes": 245612,
  "uploadedBy": {
    "id": "auth0|550e8400-e29b-41d4-a716-446655440000",
    "imageUrl": "https://example.com/avatar.png",
    "userName": "Jane Doe"
  },
  "uploaded_at": "2026-04-01T10:11:12.123Z",
  "used_in": [
    {
      "file_link_id": "890e8400-e29b-41d4-a716-446655440000",
      "product_id": "660e8400-e29b-41d4-a716-446655440000",
      "target_id": "770e8400-e29b-41d4-a716-446655440000",
      "target_type": "item"
    }
  ],
  "userTitle": "Compressor specification"
}

{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}

{
  "error": "forbidden",
  "message": "Access denied"
}

{
  "error": "not_found",
  "message": "Not found"
}

{
  "error": "validation_error",
  "message": "Invalid data format",
  "details": {
    "errors": [
      {
        "loc": [
          "body",
          "field_name"
        ],
        "msg": "field required",
        "type": "value_error.missing"
      }
    ]
  }
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests"
}