API Reference Overview
"Complete guide to the WISEROWS REST API — 65+ endpoints across 14 categories."
3 min read
API Reference Overview
The WISEROWS REST API gives you programmatic access to everything in the platform — entities, content buckets, workflows, SEO tools, AI chat, and more. All endpoints accept and return JSON, use Bearer token authentication, and follow a consistent response format.
See API Authentication for setup.
Base URL
https://api.wiserows.com/api/v1
All endpoints are prefixed with /api/v1. Include your Bearer token in the Authorization header with every request:
Authorization: Bearer ds_your_api_key_here
Content-Type: application/json
Quick Reference
14 of 14
Category | Endpoints | Description |
|---|---|---|
| Entities | 5 | CRUD operations on entities — the core data objects |
| Entity Types | 4 | Manage schema definitions for entity structures |
| Content Buckets | 6 | Organize entities into publishable content collections |
| Topical Clusters | 5 | Group related content into topical authority clusters |
| Workflows | 5 | Create and run multi-step AI workflows |
| Keywords | 5 | Manage SEO keywords and track performance |
| Jobs | 3 | Monitor background jobs and long-running operations |
| Integrations | 4 | Manage external service connections and syncs |
| SEO Pipeline | 2 | Publish content and track SEO readiness |
| Chat / AI | 2 | Interact with AI assistant and generate content |
| Knowledge Base | 2 | Manage knowledge base articles for AI context |
| Notes | 4 | Personal and project-level notes |
| Audit Log | 1 | View history of all actions in the project |
| Project | 1 | Project-level information and configuration |
Response Format
Every API response follows the same envelope structure, whether the request succeeds or fails.
Permission Levels
API keys are scoped to a permission level. Each endpoint requires a minimum level:
3 of 3
Level | Description |
|---|---|
read | Can query and list resources. Cannot create, update, or delete. |
write | Everything in read, plus create, update, and delete operations. |
admin | Everything in write, plus project settings, integrations, and audit log access. |
Error Codes
6 of 6
HTTP Status | Meaning |
|---|---|
400 | Bad Request — invalid or missing parameters. Check the details field for specifics. |
401 | Unauthorized — missing or invalid API key. |
403 | Forbidden — your API key does not have the required permission level. |
404 | Not Found — the requested resource does not exist or belongs to another project. |
429 | Too Many Requests — rate limit exceeded. Retry after the Retry-After header value. |
500 | Internal Server Error — something went wrong on our end. Contact support if it persists. |
Tip
Looking for the interactive API explorer? Sign in and visit Settings > API Docs to try endpoints live.
Was this helpful?