# API Conventions

> API Conventions Skill

- Skill: `kaewz-manga/api-conventions` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kaewz-manga/api-conventions`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kaewz-manga/api-conventions/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: kaewz-manga (https://skillmd.com/u/kaewz-manga)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kaewz-manga/api-conventions

---

# API Conventions Skill

> REST API patterns for cl-n8n-mcp.

---

## Endpoints

| Method | Path | Auth | Description |
|--------|------|------|-------------|
| GET | `/` | No | Server info |
| GET | `/health` | No | Health check |
| GET | `/stats` | API Key | Usage stats |
| POST | `/mcp` | Yes | MCP endpoint |
| DELETE | `/mcp` | Yes | Terminate session |

## Authentication

### Multi-Tenant Headers
```
x-n8n-url: https://n8n.example.com
x-n8n-key: n8n_api_key_here
```

### SaaS API Key (wrapper)
```
Authorization: Bearer n2f_xxxxxxxxxxxxx
```

## Response Format

### Success
```json
{
  "success": true,
  "data": { ... }
}
```

### Error
```json
{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded"
  }
}
```

## Rate Limit Headers

```
X-RateLimit-Limit: 50
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1704067200
```