Skip to main content

​
API

The Dilli Studio API is a straightforward JSON API secured with a single header. Grab a key, add it to your requests, and you are set.

​
Essentials

  • Base URL: https://app.dilli.studio/api/v1
  • Auth: Add X-Api-Key: YOUR_KEY to every request. Create or revoke keys in Settings -> API Keys.
  • Spec: Use the OpenAPI file to explore endpoints or generate clients: /openapi/dilli.openapi.yaml.

​
Quick start

  • Test with a simple call like GET /contacts using your key.
  • When working with deals, stages have a stable external_id so integrations keep working even if you reorder stages.
  • Most resources support the basics: list, create, update, and archive/delete where it makes sense.

​
Tips

  • Keep one key per environment (dev/staging/prod) for safety.
  • Use the API for bulk imports, syncs, or embedding Dilli data in your own tools.
  • Rotate keys if they are ever exposed; you can create a new one and delete the old immediately.