Purchase Elite API

Programmatic access to manage your organization's automation infrastructure, from workflow deployment to detailed execution logs.

v1.2.0 StableHTTPS OnlyGlobal Edge

Authentication

Authenticate via Bearer Token. You can generate limited-scope keys in the Developer Portal.

curl https://api.n8n.purchase/v1/auth/test \
  -H "Authorization: Bearer sk_live_..."

Rate Limiting

API requests are rate-limited based on your plan tier. Headers include remaining quota.

Free Tier

100 req/min

Pro Tier

1,000 req/min

Enterprise

Unlimited

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1706380800

Base URL

All endpoints are relative to the global edge network:

https://api.n8n.purchase/v1GLOBAL REGION

Workflows

Methods for listing, creating, updating, and deleting workflow states.

GET/workflows
Read Scope

List all active workflows in your authenticated workspace.

Parameters
limitintegerMax number of results (default 20, max 100).
cursorstringPagination cursor from previous response.
Response
{
  "data": [
    {
      "id": "wf_8j29d0s...",
      "name": "Lead Scoring V3",
      "active": true,
      "nodes_count": 14
    }
  ]
}
POST/workflows
Write Scope

Create a new workflow with specified configuration and nodes.

Parameters
namestringDisplay name for the workflow (required).
nodesarrayArray of node configurations (required).
connectionsobjectNode connection mappings.
settingsobjectWorkflow execution settings.
Request Body
{
  "name": "New CRM Sync",
  "nodes": [
    {
      "type": "n8n-nodes-base.webhook",
      "name": "Webhook Trigger"
    }
  ],
  "active": false
}
Response
{
  "id": "wf_k92jd8s...",
  "name": "New CRM Sync",
  "active": false,
  "created_at": "2026-01-27T22:40:00Z"
}
PUT/workflows/:id
Write Scope

Update an existing workflow's configuration, nodes, or status.

Parameters
idstringThe workflow ID (path parameter).
namestringUpdated display name.
activebooleanEnable or disable the workflow.
nodesarrayUpdated array of node configurations.
Request Body
{
  "name": "CRM Sync v2",
  "active": true,
  "settings": {
    "executionTimeout": 3600
  }
}
Response
{
  "id": "wf_k92jd8s...",
  "name": "CRM Sync v2",
  "active": true,
  "updated_at": "2026-01-27T23:00:00Z"
}
DELETE/workflows/:id
Admin Scope

Permanently delete a workflow and all associated execution history.

Parameters
idstringThe workflow ID to delete (path parameter).
forcebooleanSkip confirmation for active workflows (query param).
Response
{
  "deleted": true,
  "id": "wf_k92jd8s...",
  "executions_removed": 1247
}

Executions

Access execution logs, trigger manual runs, and retrieve execution data.

GET/executions
Read Scope

Retrieve execution history with filtering and pagination support.

Parameters
workflow_idstringFilter by specific workflow.
statusstringFilter by status: success, error, running.
limitintegerNumber of results (max 100).
Response
{
  "data": [
    {
      "id": "exec_9x8j2k...",
      "workflow_id": "wf_8j29d0s",
      "status": "success",
      "duration_ms": 1247,
      "finished_at": "2026-01-27T22:35:00Z"
    }
  ]
}
POST/executions
Execute Scope

Trigger a manual execution of a workflow with optional input data.

Parameters
workflow_idstringID of the workflow to execute (required).
dataobjectInput data to pass to the workflow.
modestringExecution mode: sync or async (default: async).
Request Body
{
  "workflow_id": "wf_8j29d0s...",
  "data": {
    "email": "user@example.com",
    "action": "subscribe"
  },
  "mode": "async"
}
Response
{
  "execution_id": "exec_a8k3j2...",
  "status": "running",
  "started_at": "2026-01-27T22:40:00Z"
}

Credentials

Securely manage third-party service credentials for your workflows.

GET/credentials
Read Scope

List all credentials (secrets are never exposed).

Parameters
typestringFilter by credential type (e.g., oauth2, api_key).
Response
{
  "data": [
    {
      "id": "cred_8k2j3d...",
      "name": "Slack Bot Token",
      "type": "slackApi",
      "created_at": "2026-01-15T10:00:00Z"
    }
  ]
}
DELETE/credentials/:id
Admin Scope

Permanently remove a credential. Workflows using it will fail.

Parameters
idstringThe credential ID to delete.
Response
{
  "deleted": true,
  "id": "cred_8k2j3d..."
}