Uploader un document

curl --request PUT \
  --url https://partner-api.marko.fr/v1/documents/external/{external_id}/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --form type=term_sheet \
  --form operation_external_id=CF-OP-001 \
  --form 'partner_metadata={"langue":"fr"}' \
  --form file=./term-sheet.pdf \
  --form 0.file='@example-file' \
  --form 1.file='@example-file'

import requests

url = "https://partner-api.marko.fr/v1/documents/external/{external_id}/upload"

files = {
    "0.file": ("example-file", open("example-file", "rb")),
    "1.file": ("example-file", open("example-file", "rb"))
}
payload = {
    "type": "term_sheet",
    "operation_external_id": "CF-OP-001",
    "partner_metadata": "{\"langue\":\"fr\"}",
    "file": "./term-sheet.pdf"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>"
}

response = requests.put(url, data=payload, files=files, headers=headers)

print(response.text)

import fs from 'fs';

const formData = new FormData();
formData.append('type', 'term_sheet');
formData.append('operation_external_id', 'CF-OP-001');
formData.append('partner_metadata', '{"langue":"fr"}');
formData.append('file', './term-sheet.pdf');
formData.append('0.file', await new Response(fs.createReadStream('example-file')).blob());
formData.append('1.file', await new Response(fs.createReadStream('example-file')).blob());

const url = 'https://partner-api.marko.fr/v1/documents/external/{external_id}/upload';
const options = {
  method: 'PUT',
  headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'},
  body: formData
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

const form = new FormData();
form.append('type', 'term_sheet');
form.append('operation_external_id', 'CF-OP-001');
form.append('partner_metadata', '{"langue":"fr"}');
form.append('file', './term-sheet.pdf');
form.append('0.file', '{
  "fileName": "example-file"
}');
form.append('1.file', '{
  "fileName": "example-file"
}');

const options = {
  method: 'PUT',
  headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};

options.body = form;

fetch('https://partner-api.marko.fr/v1/documents/external/{external_id}/upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://partner-api.marko.fr/v1/documents/external/{external_id}/upload",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"type\"\r\n\r\nterm_sheet\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"operation_external_id\"\r\n\r\nCF-OP-001\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"partner_metadata\"\r\n\r\n{\"langue\":\"fr\"}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"\r\n\r\n./term-sheet.pdf\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "external_id": "CF-DOC-001",
  "document_id": "55555555-5555-5555-5555-555555555555",
  "created": true,
  "document": {
    "id": "55555555-5555-5555-5555-555555555555",
    "operation_id": "44444444-4444-4444-4444-444444444444",
    "spv_id": "33333333-3333-3333-3333-333333333333",
    "fond_id": null,
    "type": "term_sheet",
    "filename": "term-sheet.pdf",
    "state": "active",
    "version": 1,
    "storage_path": "https://partner-api.marko.fr/api/documents/download/clubfunding/55555555-5555-5555-5555-555555555555?exp=1760000000&sig=abc123",
    "partner_metadata": {
      "langue": "fr"
    },
    "created_at": "2026-03-26T09:12:00Z"
  }
}

{
  "external_id": "CF-DOC-001",
  "document_id": "55555555-5555-5555-5555-555555555555",
  "created": true,
  "document": {
    "id": "55555555-5555-5555-5555-555555555555",
    "operation_id": "44444444-4444-4444-4444-444444444444",
    "spv_id": "33333333-3333-3333-3333-333333333333",
    "fond_id": null,
    "type": "term_sheet",
    "filename": "term-sheet.pdf",
    "state": "active",
    "version": 1,
    "storage_path": "https://partner-api.marko.fr/api/documents/download/clubfunding/55555555-5555-5555-5555-555555555555?exp=1760000000&sig=abc123",
    "partner_metadata": {
      "langue": "fr"
    },
    "created_at": "2026-03-26T09:12:00Z"
  }
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "Idempotency-Key must contain at most 255 visible ASCII characters without spaces.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "A valid bearer token is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "The API key does not allow this operation.",
  "request_id": "req_example_partner_call"
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "type": "about:blank",
  "request_id": "<string>",
  "scope": "<string>",
  "route_id": "<string>",
  "reason_code": "<string>"
}

{
  "type": "about:blank",
  "title": "Conflict",
  "status": 409,
  "detail": "The idempotency key payload, external reference, target, or source conflicts with an existing write.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Unprocessable Content",
  "status": 422,
  "detail": "The request payload or parameters are invalid.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Precondition Required",
  "status": 428,
  "detail": "The Idempotency-Key header is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "The request rate limit was exceeded.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected server error occurred.",
  "request_id": "req_example_partner_call"
}