# Terramine Desk developer documentation

> Headless CRM and ERP integration for customer workspaces. Fetch /api/v1/openapi.json on the customer's own HTTPS workspace to identify its deployment/release contract. Module enablement, entitlements, key scopes and database readiness are checked by business requests. Send production credentials only to that workspace. Example tenant origin: https://YOUR-WORKSPACE.YOUR-REGION.terraminedesk.ai. Replace the entire example with the address shown in Admin → Integrations, including its region. Neither placeholder is a default.

## Build an integration
- [Build AI agent tools](https://docs.terraminedesk.ai/docs/agents.md): tool permissions, safe writes, reconciliation and signed events.
- [Hosted OpenAPI 3.1 JSON](https://docs.terraminedesk.ai/docs/openapi.json): operation IDs, schemas and scopes.
- [Quickstart](https://docs.terraminedesk.ai/docs/quickstart.md): make your first authenticated request, create a draft, or link an external ERP order to a deal.
- [Changelog and v1 compatibility](https://docs.terraminedesk.ai/docs/changelog.md): changes and versioning policy.
- [Swagger reference](https://docs.terraminedesk.ai/docs/reference.html): browse the contract without credentials.

- [Own-deployment OpenAPI 3.1 JSON](https://docs.terraminedesk.ai/docs/openapi-own.json): complete own-deployment CRM, ERP and accounting operation schemas, scopes and behavior. Use only for an own deployment; fetch the target workspace contract to confirm availability.

## Connect without code
- [Set-up guides](https://docs.terraminedesk.ai/#guides): how an administrator connects mailboxes, WhatsApp, Instagram, Messenger, Telegram, WeChat, couriers, accounting and the other connections from the product, one page each. A guide says whether it is for a hosted workspace, an own deployment, or both.

## Workflow example
- [n8n example](https://docs.terraminedesk.ai/docs/workflow.json): import the draft-order workflow into your private n8n workspace. Configure your tenant URL, service-key credential, customer and quote_request_id; preserve the request ID and payload through retries.

- [Customer example kit](https://docs.terraminedesk.ai/docs/downloads/terramine-integration-kit.zip): standalone Python client, synthetic local demo, request replay and webhook verification. No private source access required.

## Source development
- [Local development guide](https://docs.terraminedesk.ai/docs/README.md): developer-only disposable environment requiring private Terramine source access. Customer integrations use their own workspace.