---
title: "Schedule workspace readiness"
method: POST
path: "/v1/research-workspaces/{id}/schedule"
tags: ["Research workspaces"]
---

# Schedule workspace readiness

`POST /v1/research-workspaces/{id}/schedule`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/research-workspaces/{id}/schedule`
- Auth: HTTP bearer

Begins preparation 15 minutes before ready_by. Customer compute metering begins when readiness is observed. stop_at is optional.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `ready_by` string, date-time, required
  - `stop_at` string, date-time

## Response `201`

Wake plan created

- object

## Other responses

- `default`: Invalid schedule, active schedule, authentication or transient failure.

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)