Složky a zařazení dokumentu (folder_id)

Dokument můžete rovnou při založení zařadit do složky ve workspace. Složky a štítky jsou v Signi jeden systém — složka je štítek s "is_folder": true.

Vytvoření složky

curl -X POST -H "x-api-key: VAS_API_KLIC" -H "Content-Type: application/json" \
  https://api.signi.com/api/v1/tags/create \
  -d '{ "name": "Objednávky 2026", "is_folder": true }'

Vrátí se ID nové složky (číslo). Existující složky najdete ve výpisu štítků — složky mají "is_folder": true.

Dokument do složky

Při zakládání dokumentu přidejte folder_id:

{
    "people": [
        { "is_proposer": true, "email": "vas@email.cz", "contract_role": "approve" },
        { "is_proposer": false, "email": "protistrana@email.cz", "contract_role": "sign",
          "first_name": "Jan", "last_name": "Novák", "person_type": "nature",
          "positions": [ { "x": 50, "y": 80, "page": 0 } ] }
    ],
    "folder_id": 123,
    "file": "uploaded_file_key"
}

Pozor: neexistující folder_id nevrátí chybu — dokument se založí a zařazení se tiše přeskočí. Ověřte si ID složky ve výpisu štítků.

Kam dál

• Štítky
• JSON pro vytvoření dokumentu — přehled všech položek