# Create Unit Offering

**POST /api/v1/unit-offerings**

Create a new unit offering by linking a unit version to a course intake, lecturer, and semester. This creates the actual teaching instance of a unit.


## Servers
- Local server: http://localhost:3500 (Local server)
- Production server: https://api.echoplain.social (Production server)



## Parameters



### Body: application/json (object)

- **unitVersionId** (string)
  Unit version ID that this offering is based on
- **courseIntakeId** (string)
  Course intake ID (links to cohort intake)
- **lecturerId** (string)
  Lecturer assigned to teach this unit offering
- **semesterId** (string)
  Semester when this unit is offered
- **Code** (string)
  Unique code for this unit offering (e.g., CS101-2024-1)
- **personalizedOutline** (string)
  Customized outline for this specific offering
- **studentGroupingsEnabled** (boolean)
  Whether to enable student groupings for collaborative work


## Responses
### 201
Unit offering created successfully

#### Body: application/json (object)
- **message** (string)
  Response message
- **offering** (object)
  Created unit offering

### 400
Invalid input data or validation errors

### 401
Authentication required

### 403
Admin or Lecturer privileges required

### 404
Related entity not found (unit version, course intake, lecturer, or semester)

### 409
Unit offering code already exists


[Powered by Bump.sh](https://bump.sh)