API Reference

All requests to the Workrock API must include the Bearer token obtained during the Iframe Handshake.

Base URL: http://localhost:8000/api/v1 (Dev) | https://api.workrock.in/api/v1 (Prod)

CRM Endpoints

List Leads

GET /crm/leads Returns a list of leads for the current organization.

Create Deal

POST /crm/deals

{
    "name": "New SaaS Enterprise Deal",
    "value": 5000,
    "stage": "discovery"
}

Project Management

List Projects

GET /projects Fetches all projects the user has access to.

Get Tasks

GET /tasks?project_id={id} Returns tasks for a specific project.

Update Task

PATCH /tasks/{id} Update status, priority, or assignee.

Error Handling

The API returns standard HTTP status codes:

• 200/201: Success.
• 401: Unauthorized (Token expired or missing).
• 403: Forbidden (User doesn’t have permission for this organization).
• 404: Not Found.
• 422: Validation Error (Check your request body).