Skip to main content

Task management

Task management is in preview and available in the v1alpha2 API. Requests, responses, and activity-log payloads described in this guide may change without notice.

This guide covers requesting, reassigning, cancelling, and completing review tasks — the same review workflow Thirdfort portal users have today — from your own integration, including completing a review on behalf of a named user.

Requires the Task Management feature set, arranged with Thirdfort as part of your account setup. See Concepts and the task model for the entitlement and the resource model in full.

Guide pages​

Concepts and the task model​

The ManualTask resource, its status lifecycle, the automations that create and retire review tasks, the invariants the API enforces, and the delegation model that lets an integration act for a named user via on_behalf_of.

Building a task queue​

ListManualTasks — filtering, ordering, pagination — plus the batched calls (BatchGetChecks, BatchGetRiskSummaries, ListRiskIndicators) and the ListUsers lookup needed to render a usable queue view.

The review workflow​

Requesting a review, reassigning it, cancelling it, and completing it — including the delegated and atomic create-and-complete paths, and the errors each operation returns.

Observing outcomes​

Notifications, polling composite_status, and the activity log — with the exact payload fields for each review-task event and how to resolve actor names.

Getting started​

Read Concepts and the task model first — the delegation model it describes underpins every write operation in this guide. Then work through the pages in order: build a queue, act on it, observe the result.