---
title: "Creates a new autopilot for the project with the specified id."
method: POST
path: "/projects/{projectId}/autopilot"
tags: ["autopilot"]
---

# Creates a new autopilot for the project with the specified id.

`POST /projects/{projectId}/autopilot`

Creates a new autopilot for the project with the specified id.
            Also creates and enables all alerts for the new autopilot.
            For this action, the user needs to be the owner of the project or must have 'read' permissions
            of the feature 'project-master-data' globally or in their project role.

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

## Path parameters

- `projectId` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- AutopilotPostForm
  - `type` string, required — The type of the autopilot.
  - `alerts` AlertPostForm[], nullable — The alerts of the autopilot. Omit this collection or provide an empty collection to enable every available alert with its default settings. A non-empty collection must contain every alert type returned by GET /autopilot/availablealerts.
    - `alert` string, required — The alert indicator.
    - `enabled` boolean, required — Whether the alert is enabled.
    - `channel` string, required — The channel of the alert.

## Response `200`

OK

- Autopilot
  - `type` string, required — The type of the autopilot.
  - `enabled` boolean, required — Whether the autopilot is enabled.
  - `alerts` AlertForm[], required — The alerts of the autopilot. The collection must contain every alert type returned by GET /autopilot/availablealerts, including alerts that should be disabled.
    - `id` string, uuid, required — The id of the alert.
    - `alert` string, required — The alert indicator.
    - `enabled` boolean, required — Whether the alert is enabled.
    - `channel` string, required — The channel of the alert.
  - `id` string, uuid — The id of the autopilot.
  - `createdOn` string, date-time — The date this object was created.
  - `createdBy` string, uuid — The id of the user who created this object.
  - `updatedOn` string, date-time — The date this object was last modified.
  - `updatedBy` string, uuid — The id of the user who last modified this object.

---

[API](https://skmtc.net/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.net/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awork-io/api-v1-reference/revisions/e022e57f681a/schema)