API Endpoint

GET /management/slugs/{name}

Fetch one slug policy template by slug name.

GET /management/slugs/{name}

Endpoint context

Use these endpoints from internal tooling or your frontend backend to manage slug policy templates, provisioning API keys, and webhook endpoint configuration. Management routes require the management bootstrap key configured via MANAGEMENT_API_KEYS or MANAGEMENT_API_KEY.

  • Requires management API key auth.
  • Path slug name must be lowercase URL-safe.
  • Useful for edit forms and operator diagnostics.
bash
curl -sS http://localhost:8080/management/slugs/pro-monthly \
  -H "Authorization: Bearer management_key_dev_123456"

Request body

json
{} (no request body)

Response body

json
{
  "id": 2,
  "name": "pro-monthly",
  "max_activations": 3,
  "expiration_type": "duration",
  "expiration_days": 30,
  "fixed_expires_at": null,
  "is_default": false,
  "created_at": "2026-04-21T12:00:00Z",
  "updated_at": "2026-04-21T12:00:00Z"
}

Response field types

name

string

Slug key used by generation calls.

max_activations

number

Seat limit configured on this slug template.

expiration_type

"forever" | "duration" | "fixed_date"

Expiration policy mode.

Error codes

400

Invalid slug name format in path.

401

Missing or invalid management API key.

404

Slug not found.

500

Unexpected server or storage error.

Back to API overview