---
title: "Initialize job title assignments"
method: POST
path: "/cohorts/{id}/job-assignments/initialize"
tags: ["Cohorts"]
---

# Initialize job title assignments

`POST /cohorts/{id}/job-assignments/initialize`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/cohorts/{id}/job-assignments/initialize`
- Auth: HTTP bearer

Create unassigned job title entries for all active job titles. Use when setting up a new cohort.

## Path parameters

- `id` string, uuid, required

## Response `201`

Job title assignments initialized successfully

- object
  - `success` boolean
  - `data` CohortJobTitleAssignment[]
    - `id` string, uuid
    - `cohort_id` string, uuid
    - `job_title_id` string, uuid
    - `job_title_name` string: Name of the job title
    - `job_title_description` string, nullable: Description of the job title
    - `user_id` string, uuid, nullable: ID of the assigned user (null if unassigned)
    - `user_name` string, nullable: Full name of the assigned user
    - `user_email` string, nullable: Email of the assigned user

## Other responses

- `401`: Unauthorized
- `404`: Cohort not found
- `409`: Job title assignments already exist for this cohort

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)