Tasks

Create and manage standalone tasks. View tasks in list or calendar format. Toggle completion status.

All Tasks endpoints require JWT authentication via the Authorization: Bearer <token> header.

Core Endpoints

GET /tasks List tasks
JWT Required

Retrieve a paginated list of tasks with optional filters.

Query Parameters

NameTypeRequiredDescription
page integer Optional Page number for pagination. Default: 1
per_page integer Optional Number of results per page (max 100). Default: 25. Max: 100
search string Optional Search term to filter results
status string Optional Values: pending, completed
priority string Optional Values: low, medium, high
assigned_to integer Optional
due_date_from string Optional
due_date_to string Optional
date_from string Optional Filter by created_at start date (YYYY-MM-DD)
date_to string Optional Filter by created_at end date (YYYY-MM-DD)
scope string Optional Filter by user scope (me, team, company). Values: me, team, company
sort_by string Optional Sort field (default: due_date). Values: title, due_date, status, priority, type, assigned_to_name, deal_title, company_name, created_at
sort_dir string Optional Sort direction (default: ASC). Values: ASC, DESC

Response

Paginated task list

{
    "data": [
        {
            "id": 15,
            "title": "Follow up with client",
            "description": "...",
            "due_date": "2026-02-20",
            "due_time": "14:00",
            "priority": "medium",
            "status": "pending",
            "assigned_to": 1,
            "contact_id": 1,
            "company_id": 1,
            "deal_id": 1,
            "created_at": "2026-01-15T09:30:00.000000Z"
        }
    ],
    "current_page": 1,
    "last_page": 1,
    "per_page": 1,
    "total": 1
}

Code Examples

curl -X GET "https://crm.revorbit.com/api/tasks" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
const response = await fetch(
  "https://crm.revorbit.com/api/tasks",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
    }
  }
);
const data = await response.json();
POST /tasks Create task
JWT Required

Request Body

NameTypeRequiredDescription
title string Required
description string Optional
due_date date Optional
due_time string Optional
priority string Optional Values: low, medium, high
assigned_to integer Optional
contact_id integer Optional
company_id integer Optional
deal_id integer Optional

Code Examples

curl -X POST "https://crm.revorbit.com/api/tasks" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "...",
    "description": "...",
    "due_date": "2026-01-15",
    "due_time": "...",
    "priority": "low",
    "assigned_to": 1,
    "contact_id": 1,
    "company_id": 1,
    "deal_id": 1
}'
const response = await fetch(
  "https://crm.revorbit.com/api/tasks",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
      "Content-Type": "application/json"
    },
    body: JSON.stringify(
      {
          "title": "...",
          "description": "...",
          "due_date": "2026-01-15",
          "due_time": "...",
          "priority": "low",
          "assigned_to": 1,
          "contact_id": 1,
          "company_id": 1,
          "deal_id": 1
      }
    )
  }
);
const data = await response.json();
GET /tasks/calendar Calendar view
JWT Required

Retrieve tasks formatted for calendar display.

Query Parameters

NameTypeRequiredDescription
start string Optional Calendar range start
end string Optional Calendar range end

Code Examples

curl -X GET "https://crm.revorbit.com/api/tasks/calendar" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
const response = await fetch(
  "https://crm.revorbit.com/api/tasks/calendar",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
    }
  }
);
const data = await response.json();
GET /tasks/{id} Get task
JWT Required

Path Parameters

NameTypeRequiredDescription
id integer Required Resource ID

Code Examples

curl -X GET "https://crm.revorbit.com/api/tasks/{id}" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
const response = await fetch(
  "https://crm.revorbit.com/api/tasks/{id}",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
    }
  }
);
const data = await response.json();
PUT /tasks/{id} Update task
JWT Required

Path Parameters

NameTypeRequiredDescription
id integer Required Resource ID

Request Body

NameTypeRequiredDescription
title string Required
description string Optional
due_date date Optional
due_time string Optional
priority string Optional Values: low, medium, high
assigned_to integer Optional
contact_id integer Optional
company_id integer Optional
deal_id integer Optional

Code Examples

curl -X PUT "https://crm.revorbit.com/api/tasks/{id}" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "...",
    "description": "...",
    "due_date": "2026-01-15",
    "due_time": "...",
    "priority": "low",
    "assigned_to": 1,
    "contact_id": 1,
    "company_id": 1,
    "deal_id": 1
}'
const response = await fetch(
  "https://crm.revorbit.com/api/tasks/{id}",
  {
    method: "PUT",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
      "Content-Type": "application/json"
    },
    body: JSON.stringify(
      {
          "title": "...",
          "description": "...",
          "due_date": "2026-01-15",
          "due_time": "...",
          "priority": "low",
          "assigned_to": 1,
          "contact_id": 1,
          "company_id": 1,
          "deal_id": 1
      }
    )
  }
);
const data = await response.json();
DELETE /tasks/{id} Delete task
JWT Required

Path Parameters

NameTypeRequiredDescription
id integer Required Resource ID

Code Examples

curl -X DELETE "https://crm.revorbit.com/api/tasks/{id}" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
const response = await fetch(
  "https://crm.revorbit.com/api/tasks/{id}",
  {
    method: "DELETE",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
    }
  }
);
const data = await response.json();
PUT /tasks/{id}/toggle Toggle completion
JWT Required

Toggle a task between pending and completed status.

Path Parameters

NameTypeRequiredDescription
id integer Required Resource ID

Code Examples

curl -X PUT "https://crm.revorbit.com/api/tasks/{id}/toggle" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
const response = await fetch(
  "https://crm.revorbit.com/api/tasks/{id}/toggle",
  {
    method: "PUT",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
    }
  }
);
const data = await response.json();