Automette docs
API Reference

Publish a form

POST
/api/v1/forms/{id}/publish

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key from Settings → API Keys.

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/forms/string/publish"
{  "id": "cm4frm2xy0001kp04a7c9v1de",  "status": "published",  "version": 3,  "public_url": "https://forms.automette.com/abc123",  "embed_url": "https://forms.automette.com/abc123/embed",  "published_at": "2026-08-15T09:12:44.000Z"}

Delete a form DELETE

Moves the form to the trash and closes it, so the public link stops collecting straight away. Responses are kept. A trashed form is no longer addressable through this API — restore it from the dashboard. Pass `permanent=1` to destroy the form and every response it holds instead. That cannot be undone.

Get a form's template connection GET

Whether this form generates a document, and how it is mapped. When connected, `variables` lists every field the template exposes, so you can build or check a mapping without a second request.