Get all completed tasks of request input

1 min

GET

https://api.app.kognic.com/v1/request-inputs/{requestInputId}/completed-tasks

List every completed task for a request input, across all phases, ordered newest first. A task counts as completed once it has a completed assignment that produced an annotation.

Access: the caller must be a producer on the request, otherwise 403. This is stricter than the list/get endpoints above, which also allow owners and reviewers. Returns 404 if the input does not exist.

Each entry reports the phase, task type (Annotate/Review/Correct), and who completed it and when. The per-task annotation reference is not exposed here; use lastCompletedAnnotationId from the request-input endpoints for the input's latest annotation.

Path Parameters

requestInputIdstring<uuid>required
Format
uuid

Responses

200

Enveloped_Seq_CompletedTask
- dataCompletedTask[]
  - completedAtstring<date-time>required
    Format
    date-time
  - completedByUserIdinteger<int64>required
    Format
    int64
  - requestInputIdstring<uuid>required
    Format
    uuid
  - requestPhaseIdstring<uuid>required
    Format
    uuid
  - taskTypeTaskTyperequired

400Bad request

BadRequest
- errorCodestring
- messagestringrequired

401Unauthorized

Unauthorized
- messagestringrequired

403Forbidden

Forbidden
- messagestringrequired

404Not found

NotFound
- messagestringrequired

413Payload too large

PayloadTooLarge
- messagestringrequired

500Internal server error

InternalServerError
- messagestringrequired

python

import requests
import json

url = "https://api.app.kognic.com/v1/request-inputs/{requestInputId}/completed-tasks"

payload = {}
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

200

{
  "data": [
    {
      "completedAt": "",
      "completedByUserId": "",
      "requestInputId": "",
      "requestPhaseId": "",
      "taskType": ""
    }
  ]
}

400

// Bad request
{
  "errorCode": "",
  "message": ""
}

401

// Unauthorized
{
  "message": ""
}

403

// Forbidden
{
  "message": ""
}

404

// Not found
{
  "message": ""
}

413

// Payload too large
{
  "message": ""
}

500

// Internal server error
{
  "message": ""
}