---
title: "Pause or unpause a workspace"
method: POST
path: "/workspaces/{namespace}/{name}/actions/pause"
tags: ["workspaces"]
---

# Pause or unpause a workspace

`POST /workspaces/{namespace}/{name}/actions/pause`

Pauses or unpauses a workspace, stopping or resuming all associated pods.

## Path parameters

- `namespace` string, required
- `name` string, required

## Request body

- ApiWorkspaceActionPauseEnvelope
  - `data` ActionsWorkspaceActionPause, required
    - `paused` boolean, required

## Response `200`

Successful action. Returns the current pause state.

- ApiWorkspaceActionPauseEnvelope
  - `data` ActionsWorkspaceActionPause, required
    - `paused` boolean, required

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized. Authentication is required.
- `403` — Forbidden. User does not have permission to access the workspace.
- `404` — Not Found. Workspace does not exist.
- `409` — Conflict. Workspace not in valid state for action.
- `413` — Request Entity Too Large. The request body is too large.
- `415` — Unsupported Media Type. Content-Type header is not correct.
- `422` — Unprocessable Entity. Validation error.
- `500` — Internal server error. An unexpected error occurred on the server.

---

[API](https://skmtc.net/opendatahub-io/apis/kubeflow-notebooks-api.md) · [All operations](https://skmtc.net/opendatahub-io/apis/kubeflow-notebooks-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opendatahub-io/kubeflow-notebooks-api/versions/257ea068094f/schema)