Archive an automation

Archive an automation for good: everyone still in it leaves it, and it sends nothing more.

POSThttps://app.usenotix.dev/api/v1/automations/{id}/archive

Needs a full access key. Sending access keys cannot call this. Key permissions lists the extra rules some calls have.

Archive an automation for good: everyone still in it leaves it, and it sends nothing more. It cannot be turned on again.

Who can call it

A full access key created by a team admin, as on the dashboard. Every refusal is 403:

CodeWhy
SCOPE_DENIEDThe key is not a full access key (send-only, read-only or live AI).
FORBIDDENThe key was made by a team member without admin rights, or before Notix recorded who made each key. Create a new key as a team admin.
DOMAIN_PINNEDThe key is limited to one domain and an email step, or the sender, is on another.

A key limited to one domain sees only automations whose every email step sends from its domain; any other automation answers 404.

Path parameters

idstringrequired

Headers

Authorizationstringrequired

Bearer followed by your API key.

Errors

403

`SCOPE_DENIED`: the key is not a full access key (send-only, read-only or live AI). `FORBIDDEN`: the key was made by a team member without admin rights, or before Notix recorded who made each key. `DOMAIN_PINNED`: the key is limited to one domain and an email would send from another.

404

No journey with this id for the calling team (or, for a pinned key, on its domain).

Every error has the same shape. See all error codes.

curl -X POST "https://app.usenotix.dev/api/v1/automations/<id>/archive" \
  -H "Authorization: Bearer $NOTIX_API_KEY"
Response200
{
  "id": "cly1jrn8x0000abcd1234",
  "name": "Welcome series",
  "status": "ACTIVE",
  "triggerType": "CONTACT_ADDED",
  "contactBookId": "cly1book0000abcd1234",
  "segmentId": "cly1seg00000abcd1234",
  "exitWhenLeavesSegment": false,
  "triggerEvent": "payment.failed",
  "steps": [
    {
      "id": "cm1x8f3k20001qz7v5b9d2e4a",
      "type": "EMAIL",
      "from": "Acme <receipts@acme.com>",
      "subject": "Your receipt for order 4471"
    }
  ],
  "connections": [
    {
      "from": "trigger",
      "to": "stp_a1b2c3d4e5f6"
    }
  ],
  "copiedFromId": "cm1x8f3k20001qz7v5b9d2e4a",
  "stats": {
    "enrolled": 1,
    "active": 1,
    "completed": 1,
    "exited": 1,
    "failed": 1,
    "sentByStep": {
      "stp_abc123": 12
    }
  },
  "createdAt": "2026-10-01T09:00:00Z",
  "updatedAt": "2026-10-01T09:00:00Z"
}
Open in ClaudeOpen in ChatGPT