---
title: "Get Or Create Trial Run"
method: POST
path: "/teacher/assignments/{assignment_id}/trial-run"
tags: ["teacher_assignments"]
---

# Get Or Create Trial Run

`POST /teacher/assignments/{assignment_id}/trial-run`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/teacher/assignments/{assignment_id}/trial-run`
- Auth: OAuth 2 (password, token URL `api/login`)

Get or create a trial run session for a teacher to test their assignment.
Returns existing session if found, creates new one if not.

## Path parameters

- `assignment_id` string, required

## Response `200`

Successful Response

- RoutersExerciseAssignmentsBasicResponse
  - `status` string, required
  - `message` string, required
  - `assignment_id` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/379e4a57dee8?raw)