REST API

Справочник REST API n8n

Аутентификация

API Key

# Создание ключа: Settings → API → Create API Key

curl -H "X-N8N-API-KEY: your-api-key" \
  https://n8n.example.com/api/v1/workflows

X-N8N-API-KEY: your-api-key

Workflows

Получить все workflows

GET /api/v1/workflows

Response:

{
  "data": [
    {
      "id": "123",
      "name": "My Workflow",
      "active": true,
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2025-01-15T12:00:00.000Z"
    }
  ]
}

Получить workflow по ID

GET /api/v1/workflows/{id}

Создать workflow

POST /api/v1/workflows
Content-Type: application/json

{
  "name": "New Workflow",
  "nodes": [...],
  "connections": {...},
  "settings": {...}
}

Обновить workflow

PUT /api/v1/workflows/{id}
Content-Type: application/json

{
  "name": "Updated Workflow",
  "nodes": [...],
  "connections": {...}
}

Удалить workflow

DELETE /api/v1/workflows/{id}

Активировать/деактивировать

POST /api/v1/workflows/{id}/activate
POST /api/v1/workflows/{id}/deactivate

Executions

Получить executions

GET /api/v1/executions

# С фильтрами
GET /api/v1/executions?workflowId=123&status=success&limit=10

Parameters:

Параметр	Описание
`workflowId`	ID workflow
`status`	success, error, waiting
`limit`	Количество (max 250)

Получить execution по ID

GET /api/v1/executions/{id}

Удалить execution

DELETE /api/v1/executions/{id}

Запуск Workflow

Manual Execute

POST /api/v1/workflows/{id}/execute
Content-Type: application/json

{
  "workflowData": {...}  // опционально
}

Response:

{
  "data": {
    "executionId": "456"
  }
}

Execute с данными

POST /api/v1/workflows/{id}/execute
Content-Type: application/json

{
  "workflowData": {
    "nodes": [...],
    "connections": {...}
  }
}

Credentials

Получить credentials (без секретов)

GET /api/v1/credentials

Создать credential

POST /api/v1/credentials
Content-Type: application/json

{
  "name": "My API Key",
  "type": "httpHeaderAuth",
  "data": {
    "name": "Authorization",
    "value": "Bearer token"
  }
}

Удалить credential

DELETE /api/v1/credentials/{id}

Users (Enterprise)

Получить пользователей

GET /api/v1/users

Создать пользователя

POST /api/v1/users
Content-Type: application/json

{
  "email": "user@example.com",
  "firstName": "John",
  "lastName": "Doe",
  "role": "member"
}

Variables

Получить переменные

GET /api/v1/variables

Создать переменную

POST /api/v1/variables
Content-Type: application/json

{
  "key": "API_URL",
  "value": "https://api.example.com"
}

Примеры использования

Python

import requests

API_KEY = "your-api-key"
BASE_URL = "https://n8n.example.com/api/v1"

headers = {
    "X-N8N-API-KEY": API_KEY,
    "Content-Type": "application/json"
}

# Получить workflows
response = requests.get(f"{BASE_URL}/workflows", headers=headers)
workflows = response.json()["data"]

# Запустить workflow
response = requests.post(
    f"{BASE_URL}/workflows/123/execute",
    headers=headers
)
execution_id = response.json()["data"]["executionId"]

JavaScript

const API_KEY = 'your-api-key';
const BASE_URL = 'https://n8n.example.com/api/v1';

async function getWorkflows() {
  const response = await fetch(`${BASE_URL}/workflows`, {
    headers: {
      'X-N8N-API-KEY': API_KEY
    }
  });
  return response.json();
}

async function executeWorkflow(id) {
  const response = await fetch(`${BASE_URL}/workflows/${id}/execute`, {
    method: 'POST',
    headers: {
      'X-N8N-API-KEY': API_KEY,
      'Content-Type': 'application/json'
    }
  });
  return response.json();
}

cURL

# Получить workflows
curl -H "X-N8N-API-KEY: key" \
  https://n8n.example.com/api/v1/workflows

# Запустить workflow
curl -X POST \
  -H "X-N8N-API-KEY: key" \
  -H "Content-Type: application/json" \
  https://n8n.example.com/api/v1/workflows/123/execute

# Создать workflow
curl -X POST \
  -H "X-N8N-API-KEY: key" \
  -H "Content-Type: application/json" \
  -d '{"name":"Test","nodes":[],"connections":{}}' \
  https://n8n.example.com/api/v1/workflows

Rate Limits

Endpoint	Limit
Общий	100 req/min
Execute	20 req/min

Ошибки

Код	Описание
400	Bad Request
401	Unauthorized (неверный API key)
404	Not Found
429	Rate Limit Exceeded
500	Internal Server Error

Следующие шаги

CLI команды — командная строка
Глоссарий — термины
Переменные окружения — конфигурация

REST API

Аутентификация

API Key

Header

Workflows

Получить все workflows

Получить workflow по ID

Создать workflow

Обновить workflow

Удалить workflow

Активировать/деактивировать

Executions

Получить executions

Получить execution по ID

Удалить execution

Запуск Workflow

Manual Execute

Execute с данными

Credentials

Получить credentials (без секретов)

Создать credential

Удалить credential

Users (Enterprise)

Получить пользователей

Создать пользователя

Tags

Получить теги

Создать тег

Variables

Получить переменные

Создать переменную

Примеры использования

Python

JavaScript

cURL

Rate Limits

Ошибки

Следующие шаги

Начало работы

Workflows

Ключевые концепции

AI и MCP

Интеграции

Хостинг

Код в n8n

Справочник