REST API Documentation

Authentication

Three authentication methods are supported depending on your use case.

curl -H "Authorization: Bearer gt_live_YOUR_KEY" \
  https://app.gravitask.net/api/v1/projects

Quick Start

Get up and running in three steps.

curl -H "Authorization: Bearer gt_live_YOUR_KEY" \
  https://app.gravitask.net/api/v1/projects

curl -X POST https://app.gravitask.net/api/v1/tasks \
  -H "Authorization: Bearer gt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "PROJECT_ID",
    "title": "My new task",
    "description": "Created via the API"
  }'

Endpoints Reference

All endpoints are relative to https://app.gravitask.net.

Webhooks

Receive real-time notifications when events happen in your workspace.

const crypto = require('crypto');
function verify(payload, signature, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Rate Limiting

API requests are rate-limited per workspace.

Pagination

List endpoints use cursor-based pagination. Pass limit and cursor query parameters to page through results.

GET /api/v1/projects?limit=50&cursor=eyJpZCI6IjEyMyJ9

Responses include pagination metadata:

{
  "data": [ ... ],
  "next_cursor": "eyJpZCI6IjEyMyJ9",
  "has_more": true
}

Continue fetching pages while has_more is true, passing the next_cursor value as the cursor parameter.