---
title: "POST /sites/{site_id}/dev_servers/{dev_server_id}/state"
method: POST
path: "/sites/{site_id}/dev_servers/{dev_server_id}/state"
tags: ["devServer"]
---

# POST /sites/{site_id}/dev_servers/{dev_server_id}/state

`POST /sites/{site_id}/dev_servers/{dev_server_id}/state`

## Request body

- object
  - `state` 'starting' | 'live' | 'error' | 'done', required
  - `task_id` string
  - `error` string

## Response `200`

OK

- DevServer
  - `id` string
  - `site_id` string
  - `branch` string
  - `url` string
  - `state` string
  - `created_at` string, dateTime
  - `updated_at` string, dateTime
  - `starting_at` string, dateTime
  - `error_at` string, dateTime
  - `live_at` string, dateTime
  - `done_at` string, dateTime
  - `title` string

## Other responses

- `409` — Conflict

## Changes

- **2025-10-22** `f1aa6d65f7b5` — 1 info
  - endpoint added
- **2025-10-01** `dd4e48196663` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/netlify/apis/netlify-s-api-documentation/changes/sites/:site_id/dev_servers/:dev_server_id/state/post.md)

---

[API](https://skmtc.dev/netlify/apis/netlify-s-api-documentation.md) · [All operations](https://skmtc.dev/netlify/apis/netlify-s-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netlify/netlify-s-api-documentation/revisions/71540d1b5d9d/schema)