Upload receipt
Put a receipt or supplier invoice in the Fiken inbox so it can be attached to a purchase.
POST https://cotlet.dev/api/v1/fiken/receipts
write
Uploads one file to Innboks from an https link the agent can reach, and returns its document_id and inbox status unused. It books nothing and sends nothing to anyone: the document waits in the inbox until create_purchase or a person in Fiken uses it, so upload_receipt runs without asking first.
Parameters
| Name | Type | Description |
|---|---|---|
| file_url string required | string | https link to the PDF or image to upload. |
| name string | string | Document name shown in the inbox. Default: the file name. |
| description string | string | Extra description saved with the document. |
Request
curl -X POST https://cotlet.dev/api/v1/fiken/receipts \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"file_url":"https://example.com"}'result = client.call("fiken", "upload_receipt", {"file_url":"https://example.com"})const result = await cotlet.call('fiken', 'upload_receipt', {"file_url":"https://example.com"});cotlet call fiken upload_receipt --data '{"file_url":"https://example.com"}'Example response
{
"document_id": 3318251,
"name": "Hotel Fjordgaten receipt",
"filename": "hotel-receipt.pdf",
"created_at": "2026-10-14T09:02:00+02:00",
"used": false
}