Skip to content
Optiwork API Docs

Get a user's upcoming tasks

GET
/users/{user}/dashboard
curl --request GET \
  --url 'https://projects.work.optidata.cloud/api/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/dashboard?limit=1' \
  --header 'Authorization: Bearer <token>'

Returns the user’s cards due within the next 3 days across all active boards they belong to, ordered by nearest due date. Each card includes a deep link into the Optiwork web app. The user is addressed by UUID.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
user
required
string format: uuid

The user’s UUID.

Query Parameters

Section titled “Query Parameters”
limit
required
integer
>= 1 <= 100

Maximum number of cards to return.

Responses

Section titled “Responses”

200

Section titled “200”

Upcoming cards.

Media typeapplication/json
Array<object>
object
id
integer
title
string
due_date
string format: date-time
completed_at
string | null format: date-time
board_id
integer
column_id
integer
board
object
id
integer
name
string
assignees
Array<object>
object
id
integer
uuid
string format: uuid
name
string
email
string format: email
avatar_url
string | null format: uri
link

Deep link to open the card in the Optiwork web app.

string format: uri
Example
[
  {
    "id": 9001,
    "title": "Draft homepage copy",
    "due_date": "2026-07-24T12:00:00.000000Z",
    "completed_at": null,
    "board_id": 42,
    "column_id": 301,
    "board": {
      "id": 42,
      "name": "Website Redesign"
    },
    "assignees": [],
    "link": "https://projects.work.optidata.cloud/urn/acme/UkV..."
  }
]

401

Section titled “401”

Missing, invalid or expired bearer passport.

Media typeapplication/json
object
error
string
Example
{
  "error": "JWT passport exception: Missing bearer token in request"
}

404

Section titled “404”

Resource not found, or a nested resource does not belong to its parent in the path.

Media typeapplication/json
object
message
string
Example
{
  "message": "Not found."
}

422

Section titled “422”

Validation failed.

Media typeapplication/json
object
message

First validation error message.

string
errors

Map of field name → list of error messages.

object
key
additional properties
Array<string>
Example
{
  "message": "The name field is required.",
  "errors": {
    "name": [
      "The name field is required."
    ]
  }
}