Overview

Kanban project management (boards, columns, tasks) for the Optiwork suite.

Optiwork Projects API v2026.07.23.1005

The Optiwork Projects service provides kanban-style project management: hierarchical boards (projects), columns (task lists), cards (tasks), plus tags, checklists, comments, time tracking, file attachments, custom fields and recurring tasks.

Base URL

All endpoints are served under the fixed Projects host: https://projects.work.optidata.cloud/api.

Authentication

Every endpoint (except GET /ping) requires a Bearer JWT passport. Your personal passport is available in Optiwork at https://work.optidata.cloud/user/settings/security (My account > Profile > Security), where it is shown as the authentication key. Send it on every request:

Authorization: Bearer opk_xxxxxxxxxxxxxxxxxxxxxxxx
Accept: application/json

Passports are short-lived; when a request returns 401, get a fresh authentication key from the same settings page and retry.

Permissions

Board access is governed by board membership. Each member has one permission level: view < interact < edit < manage. Operations note the level they require; requests by users without the required level return 403. Boards may also be public (visible to every user of the tenant) or private (members only).

Conventions

Identifiers in paths ({board}, {card}, …) are the numeric id of the resource unless stated otherwise. Nested resources are scope-checked: referencing a card that does not belong to the given board returns 404.
Timestamps are ISO-8601 UTC strings (e.g. 2026-03-10T17:09:05.000000Z).
Validation failures return 422 with a per-field errors map.
Responses are serialized with numeric-string coercion: numeric fields are emitted as JSON numbers.

Optidata — Optiwork Platform Team

https://www.optidata.cloud

Information

OpenAPI version: 3.1.0

Authentication

bearerAuth

Optiwork passport — the JWT shown as the authentication key at https://work.optidata.cloud/user/settings/security (My account > Profile > Security). Send it as Authorization: Bearer <token>. Passports expire; on 401, get a fresh authentication key from that page and retry.

Security scheme type: http

Bearer format: JWT