Documentation
Topics

Board, column, tag, and feature API

Discover project boards, configure Kanban columns, create colored tags, update board features, and manage board membership.

Updated October 3, 20263 min read

Before you begin

Use https://tasker.fit/api as the REST base URL. Create an active integration token in Profile → API Tokens, and send Authorization: Bearer <your-api-token>. Replace all example IDs with values returned for your account.

Planning your workflow

Board operations are scoped by company_id and board_id. Column IDs identify workflow stages inside that board; a column's kind can be todo, in_progress, done, or custom. Tasks reference column_id, so discover existing columns before creating or moving work. The authenticated project board type is kanban, and board lifecycle statuses are active, archived, and closed.

Tags are board resources with numeric IDs and colors. Create the tag before assigning its ID to a task. Board features are stored as a features map whose values contain JSON-serialized configuration. The backend merges feature keys into the existing map. A supplied key replaces that feature’s complete configuration, so read its current nested settings before updating it.

Example

Discover project boards, configure Kanban columns, create colored tags, update board features, and manage board membership.

Step-by-step tutorials / 1

Integration workflow

  1. List boards in a company and select a board_id. Read its columns and configuration.

  2. Create the workflow stages and any tags your tasks need. Save the returned IDs.

  3. Use task PATCH requests to move work to an existing column. Restrict membership and configuration writes to authorized managers.

What to expect: Read the returned data object and keep the resource identifiers for subsequent requests. Check the HTTP status before treating a write operation as successful.

Endpoints and request examples

Replace example identifiers, tokens, and dates with your own values. Each example shows fields for a specific operation, rather than a complete response schema.

Endpoint directory
MethodPathOperation
GET/board/list/List company boards
POST/board/list/Create a Kanban board
GET/board/Read board configuration
PATCH/board/Update a board
DELETE/board/Delete a board and its work
GET/board/columns/List workflow columns
POST/board/columns/Create a workflow column
PATCH/board/columns/Rename or reorder a column
DELETE/board/columns/Delete a column
GET/board/tags/List board tags
POST/board/tags/Create a colored tag
PATCH/board/tags/Edit a tag
DELETE/board/tags/Delete a tag
PATCH/board/features/Update board feature configuration
GET/board/members/List board members
POST/board/members/Add a workspace member to a board
GET/api/board/list/

List company boards

Authentication and permission for this operation are required.

URL query parameters (example)

{
  "company_id": "demo"
}

Additional fields: page, limit, q

cURL example

curl --request GET 'https://tasker.fit/api/board/list/?company_id=demo' \
  --header 'Authorization: Bearer <your-api-token>'
POST/api/board/list/

Create a Kanban board

Authentication and permission for this operation are required.

JSON request body (example)

{
  "company_id": "demo",
  "title": "Release",
  "type": "kanban",
  "color": "#FF665A"
}

Additional fields: description, position, max_assignee_count

cURL example

curl --request POST 'https://tasker.fit/api/board/list/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "title": "Release",
  "type": "kanban",
  "color": "#FF665A"
}'
GET/api/board/

Read board configuration

Authentication and permission for this operation are required.

URL query parameters (example)

{
  "company_id": "demo",
  "board_id": "RELEASE"
}

cURL example

curl --request GET 'https://tasker.fit/api/board/?company_id=demo&board_id=RELEASE' \
  --header 'Authorization: Bearer <your-api-token>'
PATCH/api/board/

Update a board

Authentication and permission for this operation are required.

URL query parameters (example)

{
  "company_id": "demo",
  "board_id": "RELEASE"
}

JSON request body (example)

{
  "status": "archived"
}

Additional fields: board_id, title, description, color, type, position, max_assignee_count

cURL example

curl --request PATCH 'https://tasker.fit/api/board/?company_id=demo&board_id=RELEASE' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "archived"
}'
DELETE/api/board/

Delete a board and its work

Authentication and permission for this operation are required.

URL query parameters (example)

{
  "company_id": "demo",
  "board_id": "RELEASE"
}

cURL example

curl --request DELETE 'https://tasker.fit/api/board/?company_id=demo&board_id=RELEASE' \
  --header 'Authorization: Bearer <your-api-token>'
GET/api/board/columns/

List workflow columns

Authentication and permission for this operation are required.

URL query parameters (example)

{
  "company_id": "demo",
  "board_id": "RELEASE"
}

cURL example

curl --request GET 'https://tasker.fit/api/board/columns/?company_id=demo&board_id=RELEASE' \
  --header 'Authorization: Bearer <your-api-token>'
POST/api/board/columns/

Create a workflow column

Authentication and permission for this operation are required.

JSON request body (example)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "title": "To do",
  "kind": "todo"
}

Additional fields: position

cURL example

curl --request POST 'https://tasker.fit/api/board/columns/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "title": "To do",
  "kind": "todo"
}'
PATCH/api/board/columns/

Rename or reorder a column

Authentication and permission for this operation are required.

URL query parameters (example)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "column_id": "todo"
}

JSON request body (example)

{
  "title": "Planned",
  "position": 0
}

Additional fields: kind

cURL example

curl --request PATCH 'https://tasker.fit/api/board/columns/?company_id=demo&board_id=RELEASE&column_id=todo' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "Planned",
  "position": 0
}'
DELETE/api/board/columns/

Delete a column

Authentication and permission for this operation are required.

URL query parameters (example)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "column_id": "<column-id>"
}

cURL example

curl --request DELETE 'https://tasker.fit/api/board/columns/?company_id=demo&board_id=RELEASE&column_id=%3Ccolumn-id%3E' \
  --header 'Authorization: Bearer <your-api-token>'
GET/api/board/tags/

List board tags

Authentication and permission for this operation are required.

URL query parameters (example)

{
  "company_id": "demo",
  "board_id": "RELEASE"
}

cURL example

curl --request GET 'https://tasker.fit/api/board/tags/?company_id=demo&board_id=RELEASE' \
  --header 'Authorization: Bearer <your-api-token>'
POST/api/board/tags/

Create a colored tag

Authentication and permission for this operation are required.

JSON request body (example)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "title": "Checkout",
  "color": "#3B82F6"
}

cURL example

curl --request POST 'https://tasker.fit/api/board/tags/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "title": "Checkout",
  "color": "#3B82F6"
}'
PATCH/api/board/tags/

Edit a tag

Authentication and permission for this operation are required.

URL query parameters (example)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "tag_id": 7
}

JSON request body (example)

{
  "title": "Payments"
}

Additional fields: color

cURL example

curl --request PATCH 'https://tasker.fit/api/board/tags/?company_id=demo&board_id=RELEASE&tag_id=7' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "Payments"
}'
DELETE/api/board/tags/

Delete a tag

Authentication and permission for this operation are required.

URL query parameters (example)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "tag_id": 7
}

cURL example

curl --request DELETE 'https://tasker.fit/api/board/tags/?company_id=demo&board_id=RELEASE&tag_id=7' \
  --header 'Authorization: Bearer <your-api-token>'
PATCH/api/board/features/

Update board feature configuration

Authentication and permission for this operation are required.

This example shows one configuration value. The backend merges supplied feature keys into the existing map; read the current value before editing a feature's nested settings.

URL query parameters (example)

{
  "company_id": "demo",
  "board_id": "RELEASE"
}

JSON request body (example)

{
  "features": {
    "qa": "{\"enabled\":true,\"settings\":{}}"
  }
}

cURL example

curl --request PATCH 'https://tasker.fit/api/board/features/?company_id=demo&board_id=RELEASE' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "features": {
    "qa": "{\"enabled\":true,\"settings\":{}}"
  }
}'
GET/api/board/members/

List board members

Authentication and permission for this operation are required.

URL query parameters (example)

{
  "company_id": "demo",
  "board_id": "RELEASE"
}

cURL example

curl --request GET 'https://tasker.fit/api/board/members/?company_id=demo&board_id=RELEASE' \
  --header 'Authorization: Bearer <your-api-token>'
POST/api/board/members/

Add a workspace member to a board

Authentication and permission for this operation are required.

JSON request body (example)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "member_id": 12,
  "role": "member"
}

cURL example

curl --request POST 'https://tasker.fit/api/board/members/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "member_id": 12,
  "role": "member"
}'

Tips & troubleshooting

  • Examples show the key request fields, not every optional field or a full response schema. Query fields belong in the URL; JSON body fields belong in the request body. Keep trailing slashes on endpoint paths.

Frequently asked questions

Can these examples be used with any account?

Only resources accessible to the token's account can be read or changed. Use returned company, board, task, and numeric resource IDs; the examples' demo values are placeholders.

What should an integration do when a request fails?

Check the HTTP status and returned error payload. Validate identifiers and required fields, then check token activity, expiry, and permissions. Do not blindly repeat a POST: a previous attempt may already have created a resource.

Continue learning