---
title: "Create baseline"
method: POST
path: "/baselines"
tags: ["Baselines (Preview)"]
---

# Create baseline

`POST /baselines`

**Preview.** Available to teams with the `baselines_api` feature flag.

Create a baseline in the team. The disk layout is validated by the same rules a deploy
applies, so a baseline that saves here can be dispatched verbatim.

## Request body

- object
  - `data` object
    - `type` 'baselines'
    - `attributes` object
      - `name` string — Name of the baseline
      - `description` string, nullable — Description of the baseline
      - `plan` string — Slug of the plan this baseline applies to
      - `ssh_key_ids` string[] — SSH keys the baseline expects on the server
      - `user_data_id` string, nullable — User data the baseline expects to run on first boot
      - `disk_layout` BaselineDiskLayoutGroup[] — Expected disk layout
        - `role` 'os' | 'storage' | 'raw' — Purpose of the disk group
        - `count` integer — Number of disks in the group
        - `raid_level` 'raid-0' | 'raid-1', nullable — RAID level for the group. Only valid for the 'os' and 'storage' roles
        - `filesystem` 'ext4', nullable — Filesystem to format the group with. Only valid for the 'storage' role
        - `mount_point` string, nullable — Where the group is mounted. Required for the 'storage' role
      - `bios` object — Expected BIOS settings, keyed by setting id

## Response `201`

Created

---

[API](https://skmtc.net/latitude/apis/latitude-sh-api.md) · [All operations](https://skmtc.net/latitude/apis/latitude-sh-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latitude/latitude-sh-api/versions/7302d79e39bb/schema)