---
title: "Get mutation status"
method: GET
path: "/mutationStatus/{requestId}"
tags: ["Miscellaneous"]
---

# Get mutation status

`GET /mutationStatus/{requestId}`

Get the status for an asynchronous mutation to know whether or not it has been completed. Each API endpoint that mutates a document will return a request id that you can pass to this endpoint to check the completion status. Status information is not guaranteed to be available for more than one day after the mutation was completed. It is intended to be used shortly after the request was made.

## Path parameters

- `requestId` string, required

## Response `200`

Info about the mutation.

- MutationStatus — The status of an asynchronous mutation.
  - `completed` boolean, required — Returns whether the mutation has completed.
  - `warning` string — A warning if the mutation completed but with caveats.

## Other responses

- `401` — The API token is invalid or has expired.
- `404` — The resource could not be located with the current API token.
- `429` — The client has sent too many requests.

---

[API](https://skmtc.net/coda/apis/superhuman-docs-api.md) · [All operations](https://skmtc.net/coda/apis/superhuman-docs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coda/superhuman-docs-api/revisions/c65a8418f3c8/schema)