---
title: "[DEPRECATED: use custom fields of type 'milestone'] Create a new milestone"
method: POST
path: "/api/workspaces/{workspaceId}/milestones"
tags: ["CRUD", "Milestones"]
deprecated: true
---

# \[DEPRECATED: use custom fields of type 'milestone'\] Create a new milestone

`POST /api/workspaces/{workspaceId}/milestones`

## Request

- Base URL: `https://app.airfocus.com`
- URL: `https://app.airfocus.com/api/workspaces/{workspaceId}/milestones`
- Auth: HTTP bearer

> **Deprecated.**

Returns newly created milestone with its sanitised data.<br/>Requirements:<br/>- auth-client scopes: "workspace"<br/>- user permission: "write" or higher

## Path parameters

- `workspaceId` string, uuid, required

## Query parameters

- `actAsAdmin` boolean

## Request body

- CreateMilestoneRequest
  - `date` string, date, required
  - `description` string, required
  - `name` string, required
  - `timezone` string

## Response `200`

- MilestoneWithEmbed
  - `_embedded` object, required
  - `createdAt` string, date-time, required
  - `date` string, date, required
  - `description` string, required
  - `id` string, uuid, required
  - `lastUpdatedAt` string, date-time, required
  - `name` string, required
  - `timezone` string
  - `workspaceId` string, uuid, required

## Other responses

- `400`: If payload is invalid.
- `401`: If missing authentication token.
- `403`: If user does not have the required permission, or authenticated client does not have the required access scopes.
- `default`: If any other error happens.

---

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