Assign users to opportunities

The endpoint assigns one or more users to one or more opportunities. If multiple user_ids are provided, multiple users are assigned. If multiple opportunity_ids are provided, each user is assigned to each opportunity.

The endpoint only accepts published opportunities that belong to your institution. If an assignment already exists, it is returned with "created": false; otherwise a new enrollment is created. All assigned enrollments are set to approved status.

The API additionally triggers: opportunity assignment notifications to users chat user creation for the assigned enrollments

Endpoint POST /api/opportunities/bulk-assign/

Payload sample

{
  "user_ids": [
    "06d9d2da-e99d-4c9a-9f95-c9acd55e9ee1",
    "de89a718-51f6-46e2-800f-56709879f179",
    "5a8046f9-e698-49b7-b69f-a732ff13502b"
  ],
  "opportunity_ids": [
    "a167ac3f-952e-417d-85e6-6d4f74306950"
  ]
}

Response sample

{
  "assignment_count": 3,
  "created_count": 3,
  "existing_count": 0,
  "enrollments": [
    {
      "id": "3b4e9461-8b34-4d5b-9c3d-48f6f85f0f01",
      "user_id": "06d9d2da-e99d-4c9a-9f95-c9acd55e9ee1",
      "opportunity_id": "a167ac3f-952e-417d-85e6-6d4f74306950",
      "created": true
    },
    {
      "id": "61a1f40d-1f5a-49f0-b3e7-34ac3f5dc6d7",
      "user_id": "de89a718-51f6-46e2-800f-56709879f179",
      "opportunity_id": "a167ac3f-952e-417d-85e6-6d4f74306950",
      "created": true
    },
    {
      "id": "a3cc6f4c-d0ed-44e5-9a94-c2e30d540f70",
      "user_id": "5a8046f9-e698-49b7-b69f-a732ff13502b",
      "opportunity_id": "a167ac3f-952e-417d-85e6-6d4f74306950",
      "created": true
    }
  ]
}