Prenzo API Documentation

Authentication

All API requests require a Bearer token. Generate API keys from Settings → API Keys.

# Include your API key in the Authorization header
curl -H "Authorization: Bearer prz_your_api_key_here" \
     https://prenzo.io/api/v1/tasks
                

API keys follow the format prz_ followed by 48 hex characters. Keep your keys secure — they provide full access to your workspace.

Rate Limits

The API allows 100 requests per minute per API key. Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
Retry-After: 60  # Only when rate limited (429)
                

Error Handling

The API uses standard HTTP status codes. Errors return JSON with an error field:

{
  "error": "Task not found",
  "code": 404
}
                

Code	Description
200	Success
400	Bad request — missing or invalid parameters
401	Unauthorized — invalid or missing API key
403	Forbidden — insufficient permissions
404	Not found
429	Rate limited — slow down
500	Server error

Tasks

Tasks are the core unit of work in Prenzo. Create, update, and manage tasks programmatically.

GET /api/v1/tasks 🔒 Auth Required

List all tasks in the workspace, with optional filters

Parameter	Type	Description
project_id	integer	Filter by project
status	string	Filter: todo, in_progress, review, done, blocked
assigned_to	integer	Filter by assignee user ID
priority	string	Filter: low, medium, high, urgent
limit	integer	Max results (default 50, max 100)

POST /api/v1/tasks 🔒 Auth Required

Create a new task

{
  "project_id": 1,           // required
  "title": "Design homepage",  // required
  "description": "...",
  "status": "todo",
  "priority": "high",
  "assigned_to": 2,
  "due_date": "2026-04-01"
}
                    

PUT /api/v1/tasks/:id

Update a task. Only send the fields you want to change.

DELETE /api/v1/tasks/:id

Soft-delete a task (moves to trash)

Projects

GET /api/v1/projects

List all projects in the workspace

GET /api/v1/projects/:id

Get project details with task counts

Users

GET /api/v1/users

List workspace members

Time Entries

GET /api/v1/time-entries

List time entries, optionally filtered by task_id or user_id

POST /api/v1/time-entries

Log a manual time entry

{
  "task_id": 42,
  "duration_minutes": 90,
  "description": "Backend development",
  "date": "2026-03-15"
}
                    

Sprints

GET /api/v1/sprints?project_id=1

List sprints for a project

Labels

GET /api/v1/labels

List all labels in the workspace

Webhooks

Subscribe to events and receive real-time HTTP callbacks when things happen in Prenzo.

Available Events

Event	Description
task.created	Fired when a new task is created
task.updated	Fired when a task is modified
task.completed	Fired when a task status changes to done
task.assigned	Fired when a task is assigned to someone
task.commented	Fired when a comment is added
sprint.started	Fired when a sprint begins
sprint.completed	Fired when a sprint ends
member.joined	Fired when a new member joins

Webhook Payload

{
  "event": "task.completed",
  "timestamp": "2026-03-15T12:00:00Z",
  "data": {
    "task": {
      "id": 42,
      "title": "Design homepage",
      "status": "done",
      ...
    }
  }
}
                

Payloads include an X-Prenzo-Signature header with an HMAC-SHA256 signature for verification.

Prenzo REST API