TaskieLog in / Sign up

API

Taskie API docs for integrating with your organization's tools

A RESTful API for integrating Taskie with your organization's internal tools and external systems, and for automating processes.
Request accessSample request
  • HTTPS + JSON
  • Bearer Token
  • Rate Limiting
  • Webhooks

Before your first request, what you need to know

01 Security

Authentication

Authentication uses a Bearer token. The token is issued once access is enabled and is sent in the header of every request; manage connected devices under the “API devices” settings.

Authorization: Bearer {token}

02 Stability

Rate limits

To keep the service stable, requests are rate-limited. If you go over the limit, you get a 429 response.

General
60 req/min
Search
30 req/min
Upload
10 req/min

03 Conventions

Basic conventions

  • Base URL: https://app.taskie.ir/api
  • Every response is JSON
  • IDs are integers
  • Dates use ISO 8601
  • Errors come back with the matching HTTP status code

Sample request and response

Fetch a project's tasks, filtered by status
RequestcURL
curl -X GET \
  "https://app.taskie.ir/api/projects/42/tasks?status=in_progress&per_page=20" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"
Response200 OK
{
  "data": [
    {
      "id": 1284,
      "title": "Design the dashboard UI",
      "status": { "id": 3, "name": "In progress", "color": "#3B82F6" },
      "assignees": [{ "id": 7, "name": "Sara Ahmadi" }],
      "due_date": "2025-04-15T00:00:00.000Z",
      "priority": "high",
      "created_at": "2025-03-01T09:30:00.000Z"
    }
  ],
  "meta": { "total": 42, "per_page": 20, "current_page": 1 }
}

API groups and available resources

The main resources available through the API

Workspaces

Manage workspaces, members and settings

  • GET/workspaces
  • POST/workspaces
  • PUT/workspaces/{id}
  • GET/workspaces/{id}/members

Projects

Create, edit and archive projects

  • GET/projects
  • POST/projects
  • GET/projects/{id}
  • PUT/projects/{id}

Tasks

The most complete API, for managing tasks

  • GET/tasks
  • POST/tasks
  • GET/tasks/{id}
  • PUT/tasks/{id}
  • DELETE/tasks/{id}

Sprints

Sprint cycles and agile reports

  • GET/projects/{id}/sprints
  • POST/sprints
  • POST/sprints/{id}/start

Mind maps

Mind map structure and data

  • GET/projects/{id}/mind-maps
  • POST/mind-maps
  • PUT/mind-maps/{id}/data

Goals (OKRs)

Set goals and track key results

  • GET/goals
  • POST/goals
  • PUT/goals/{id}
  • POST/goals/{id}/targets

Automations

Automation rules and trigger runs

  • GET/automations
  • POST/automations
  • POST/automations/{id}/toggle

Members and invitations

Invite project members, set roles and manage them

  • GET/projects/{id}/members
  • POST/projects/{id}/members/invite
  • PUT/projects/{id}/members/{uid}

API access, starts with one message

Taskie's public API is live and its coverage is growing. To enable access and get a token, or for plan limits and detailed technical docs, contact the support team.
Request accessContact us

support@taskie.ir