Assign training
Assign a guide, path, challenge or SCORM course to learners or a group.
POST https://cotlet.dev/api/v1/workramp/trainings/{training_id}/assign
write Confirm
Assigns the training the way the Assign button does and returns the assignment count. Learners already assigned are skipped. A scheduled assignment shows under Scheduled Assignments in the 3-dot menu. Learners are notified when they get their first piece of content. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| training_id string required | string | Training ID from list_trainings. |
| learner_ids string[] | string[] | Learner IDs. Give this or group. |
| group string | string | Group name. Give this or learner_ids. |
| due_date string | string | ISO date. Optional for guides, SCORM courses and paths. |
| assign_at string | string | ISO date and time to schedule the assignment; omit to assign now. |
Request
curl -X POST https://cotlet.dev/api/v1/workramp/trainings/training_8c41d2/assign \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("workramp", "assign_training", {"training_id":"training_8c41d2"})const result = await cotlet.call('workramp', 'assign_training', {"training_id":"training_8c41d2"});cotlet call workramp assign_training --data '{"training_id":"training_8c41d2"}'Example response
{
"training": "Onboarding",
"assigned": 2,
"skipped": 0,
"due_date": "2026-11-05",
"scheduled_for": null
}