Unassign learner

Remove a training assignment from learners.

POST https://cotlet.dev/api/v1/workramp/trainings/{training_id}/learner/unassign

write Confirm

Does what Unassign in the row menu does. WorkRamp deletes the record on the backend and it is gone from reporting. A guide, challenge or SCORM course inside a path cannot be unassigned alone; unassign the path. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: unassign_learner
NameTypeDescription
training_id string required string Training ID from list_trainings.
learner_ids string[] required string[] Learner IDs from list_learners or list_assignments.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/workramp/trainings/training_8c41d2/learner/unassign \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"learner_ids":["learner ids"]}'
Python
result = client.call("workramp", "unassign_learner", {"training_id":"training_8c41d2","learner_ids":["learner ids"]})
Node.js
const result = await cotlet.call('workramp', 'unassign_learner', {"training_id":"training_8c41d2","learner_ids":["learner ids"]});
CLI
cotlet call workramp unassign_learner --data '{"training_id":"training_8c41d2","learner_ids":["learner ids"]}'

Example response

JSON

{
  "training": "Onboarding",
  "unassigned": 1
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.