---
title: "POST /jobs/{jobId}/phases"
method: POST
path: "/jobs/{jobId}/phases"
tags: ["Jobs"]
---

# POST /jobs/{jobId}/phases

`POST /jobs/{jobId}/phases`

## Request

- Base URL: `https://api.fergus.com`
- URL: `https://api.fergus.com/jobs/{jobId}/phases`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.fergus.com/oauth2/authorize`
    - Token URL: `https://auth.fergus.com/oauth2/token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/fergus/apis/fergus-api/docs/jobs/:jobId/phases/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a job phase

## Path parameters

- `jobId` string, required

## Request body

- object
  - `title` string, required
  - `description` string, required

## Response `200`

Successful Response

- JobPhaseResponse
  - `result` string, required
  - `data` JobPhase, required
    - `id` number, required
    - `jobId` number, required
    - `description` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, nullable, required
    - `title` string, required
    - `status` string, required
    - `assignedGroups` string[], required
    - `links` Links[], required
      - `href` string, required
      - `rel` string, required
      - `type` 'GET' | 'POST' | 'PUT' | 'PATCH', required

## Other responses

- `4XX`: Client Request Errors
- `5XX`: Server Errors

---

[API](https://skmtc.dev/fergus/apis/fergus-api.md) - [All operations](https://skmtc.dev/fergus/apis/fergus-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fergus/apis/fergus-api/revisions/6135f517c3bf?raw)