SoftSolzSoftSolz
Sign up
HomeAPI GuideAPI ReferenceWidget Tester
tasks

List assignments. Callers without review scope see only their own.

List assignments. Callers without review scope see only their own.

GEThttps://app.softsolz.uk/api/v1/services/tasks/assignments

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Query Params

task_idinteger

Only assignments of this task.

assignee_user_idinteger

Only this person.

group_idinteger

Only assignments made through this group.

statusstring

Filter by assignment status.

overdueboolean

When "true", only past-deadline and unfinished.

awaiting_reviewboolean

When "true", only submitted work with no decision yet.

limitinteger

Page size, 1-200 (default 50).

offsetinteger

Pagination offset (default 0).

Response

Response Body · array of objects

idintegerAssignment id.
task_idintegerParent task id.
assignee_user_idintegerWho has to do the work.
assigned_byinteger | nullWho handed it out.
group_idinteger | nullThe group this assignment came through, if any.
delegated_byinteger | nullSet when a previous assignee passed their own work on, which is different from being assigned it.
delegation_reasonstring | nullWhy it was delegated.
statusstringWhere this person is in the loop.
due_atstring | nullEffective deadline for this person.
original_due_atstring | nullThe deadline first set. Never overwritten, so slippage is always measurable.
checklist_statearray of objectsPer-step progress: { id, checked_at, checked_by, note, file_keys }.
custom_fieldsobjectValues for workspace-defined fields scoped to the assignment.
scorenumber | nullRaw number from the latest review. Presentation is derived from the grading scheme.
attempt_countintegerSubmissions made so far.
started_atstring | nullWhen work began.
submitted_atstring | nullLatest submission time.
completed_atstring | nullWhen approved.
reopened_atstring | nullWhen last reopened.
updated_atstringLast change.

Request

curl --request GET \
  --url https://app.softsolz.uk/api/v1/services/tasks/assignments \
  --header 'Authorization: Bearer sk_live_your_key'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
  "data": [
    {
      "id": 900,
      "task_id": 42,
      "assignee_user_id": 31,
      "assigned_by": 8,
      "group_id": 3,
      "delegated_by": null,
      "delegation_reason": null,
      "status": "submitted",
      "due_at": "2026-09-03T17:00:00.000Z",
      "original_due_at": "2026-09-01T17:00:00.000Z",
      "checklist_state": [
        {
          "id": "floor-1",
          "checked_at": "2026-09-01T10:00:00.000Z",
          "checked_by": 31
        }
      ],
      "custom_fields": {},
      "score": 92,
      "attempt_count": 2,
      "started_at": null,
      "submitted_at": null,
      "completed_at": null,
      "reopened_at": null,
      "updated_at": "2026-09-02T08:00:00.000Z"
    }
  ],
  "meta": {
    "limit": 50,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}