Upload support document

POST

https://api.gigstack.io/v2/invoices/{id}/support-documents

Upload a supporting document (contract, proof of delivery, etc.) for an invoice.

SAT 2026 Compliance: The Mexican tax authority (SAT) can request supporting documentation
to validate invoices. This endpoint helps maintain compliance.

gigstack Connect: Upload documents for other teams' invoices using the team parameter.

Supported File Types:

PDF files (.pdf)

Images (.png, .jpg, .jpeg, .webp)

File Size Limit: 10MB

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Query Params

Body Params multipart/form-dataRequired

Responses

🟢201Created

application/json

Document uploaded successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.gigstack.io/v2/invoices//support-documents?team' \
--form 'file=@""' \
--form 'documentType=""' \
--form 'name="Service Contract"' \
--form 'description="Master services agreement for 2026"'

Response Example

201 - Example 1

{
    "success": true,
    "data": {
        "id": "doc_abc123xyz",
        "document_type": "contract",
        "name": "Service Contract.pdf",
        "description": "Main service contract for consulting services",
        "file_url": "https://storage.googleapis.com/...",
        "file_name": "contract.pdf",
        "file_size": 245680,
        "mime_type": "application/pdf",
        "compliance_status": "pending_review",
        "compliance_notes": "string",
        "valid_from": 0,
        "valid_until": 0,
        "ai_extraction": {
            "extracted_at": 0,
            "extracted_by": "ai",
            "model": "gemini-3-flash",
            "confidence": 0.95,
            "extracted_data": {
                "property1": "string",
                "property2": "string"
            },
            "warnings": [
                "string"
            ]
        },
        "audits": [
            {
                "context_type": "invoice",
                "context_id": "string",
                "audited_at": 0,
                "result": "valid",
                "summary": "string",
                "details": {
                    "property1": "string",
                    "property2": "string"
                }
            }
        ],
        "created_at": 1677651234000,
        "created_by": "user_abc123",
        "updated_at": 1677651234000,
        "linked_entities": [
            {
                "entity_type": "invoice",
                "entity_id": "string",
                "linked_at": 0
            }
        ]
    },
    "message": "Support document uploaded successfully",
    "timestamp": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-02-19 18:12:08

Get invoice files

List support documents