Create document

POST

https://api.gigstack.io/v2/documents

Register a document that has already been uploaded to storage. This endpoint records
metadata — it does not accept the file itself; upload first and pass fileUrl and
storagePath.

complianceStatus is always set server-side to pending_review on create and cannot
be supplied here; change it later with PATCH /v2/documents/{id}.

Unknown top-level keys are rejected (400 validation_failed).

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Document created.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.gigstack.io/v2/documents' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "documentType": "contract",
    "name": "Contrato de servicios 2026 — Cliente ACME",
    "description": "Contrato marco de prestación de servicios",
    "fileUrl": "https://storage.googleapis.com/gigstack-docs/team_123/contrato-acme.pdf",
    "storagePath": "teams/team_123/documents/contrato-acme.pdf",
    "fileName": "contrato-acme.pdf",
    "fileSize": 284913,
    "mimeType": "application/pdf",
    "validFrom": 1767225600000,
    "validUntil": 1798761600000,
    "tags": [
        "contrato",
        "acme"
    ],
    "linkedEntities": [
        {
            "entityType": "client",
            "entityId": "client_1234567890"
        }
    ],
    "analyzeWithAI": false
}'

Response Example

201 - Example 1

{
    "success": true,
    "data": {
        "id": "doc_1234567890",
        "document_type": "contract",
        "name": "Contrato de servicios 2026 — Cliente ACME",
        "description": "string",
        "file_url": "https://storage.googleapis.com/gigstack-docs/team_123/contrato-acme.pdf",
        "file_name": "contrato-acme.pdf",
        "file_size": 284913,
        "mime_type": "application/pdf",
        "linked_entities": [
            {
                "entity_type": "invoice",
                "entity_id": "client_1234567890",
                "linked_at": 1767225600000
            }
        ],
        "compliance_status": "pending_review",
        "compliance_notes": "string",
        "valid_from": 1767225600000,
        "valid_until": 1798761600000,
        "ai_extraction": {
            "extracted_at": 1767225600000,
            "model": "gemini-2.5-flash",
            "confidence": 0.92,
            "extracted_data": {
                "property1": "string",
                "property2": "string"
            }
        },
        "tags": [
            "contrato",
            "acme"
        ],
        "metadata": {
            "property1": "string",
            "property2": "string"
        },
        "created_at": 1767225600000,
        "created_by": "user_1234567890",
        "updated_at": 1767225600000,
        "livemode": true
    },
    "message": "Operation completed successfully",
    "timestamp": 1767225600000
}

Modified at 2026-08-05 21:48:25

List documents

Get document