Automette docs
API Reference

Create a Dynamic URL

POST
/api/v1/dynamic_urls

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key from Settings → API Keys.

In: header

Request Body

application/json

Response Body

application/json

curl -X POST "https://example.com/api/v1/dynamic_urls" \  -H "Content-Type: application/json" \  -d '{    "template_id": "cm4tpl8e20001js04xq2v9k3m",    "name": "Cohort 2026 certificates",    "formats": [      "pdf"    ],    "cache_ttl": 86400  }'
{  "id": "cmtd1x9k80001js04q2v9k3m0",  "object": "dynamic_url",  "token": "abc123def456ghij",  "base_url": "https://dyn.automette.com/d/abc123def456ghij/course-certificate.pdf",  "sample_url": "https://dyn.automette.com/d/abc123def456ghij/course-certificate.pdf?d=eyJuYW1lIjoiQWxpY2UifQ&s=a1b2c3",  "secrets": [    {      "slot": 1,      "label": "Primary",      "secret": "9f3e8c...64 hex characters"    }  ]}

List Dynamic URLs GET

Every Dynamic URL on the team. Filter to one template with `template_id`. Secret values are withheld. Ask for one with `include_secret=true` on the single-URL endpoint.

Get a Dynamic URL GET

Add `include_secret=true` to return the value of every active signing secret. They are derived, not stored, so this is a read rather than a rotation.