Assignment Service

Manages the full task lifecycle across the CRM — tasks are created by the workflow engine, auto-assigned to eligible agents based on permissions and workload, and tracked through to completion. Base URL: https://api.diginacape.co.ke/assignment

Key resources

Resource	Description
Tasks	Create, list, retrieve, and soft-delete tasks
Task status	Update task status (open, in-progress, blocked, done, cancelled)
Assignment	Claim, unclaim, reassign, or auto-assign tasks to agents
Transitions	Upsert tasks from workflow engine node transitions
Audit trail	Per-task event history with actor and payload diffs

Assignment logic

When a task is created with a required_permissions_snapshot, the service automatically resolves eligible users from the User Service and assigns the task to the agent with the lowest current workload. Manual claim and reassign endpoints allow supervisors to override auto-assignment.

See the Assignment tab in the top navigation for the full API reference.

Shared ServiceNotifications, email templates, banners, and chat integrations.

Overview

Sales

Content

Finance

Platform

Assignment Service

Key resources

Assignment logic

​Key resources

​Assignment logic

Key resources

Assignment logic