---
title: "Update managed steps for the job."
method: PUT
path: "/managed-steps/jobs/{jobId}"
tags: ["interview-templates"]
---

# Update managed steps for the job.

`PUT /managed-steps/jobs/{jobId}`

Updates managed steps for the job's hiring process.
Allows to decide whether for given hiring stage and step it is required to have an interview template assigned.

## Path parameters

- `jobId` string, uuid, required

## Request body

- ManagedStepsExternal
  - `states` ManagedStateExternal[] — List of managed states
    - `stage` 'NEW' | 'IN_PROGRESS' | 'INTERVIEW' | 'OFFER' — Name of the hiring stage that contains managed steps
    - `steps` ManagedStepStatusExternal[] — List of managed steps for the hiring stage
      - `step` string — Name of the hiring step
      - `templateRequired` boolean — Flag indicating whether this step is required to have an interview template assigned

## Response `200`

Returns managed steps.

- ManagedStepsExternal
  - `states` ManagedStateExternal[] — List of managed states
    - `stage` 'NEW' | 'IN_PROGRESS' | 'INTERVIEW' | 'OFFER' — Name of the hiring stage that contains managed steps
    - `steps` ManagedStepStatusExternal[] — List of managed steps for the hiring stage
      - `step` string — Name of the hiring step
      - `templateRequired` boolean — Flag indicating whether this step is required to have an interview template assigned

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Job Not found

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/revisions/449bdc2516c9/schema)