Auth: required. Send an ivy_ API key (Authorization: Bearer ivy_… or X-Ivy-Api-Key), a Clerk session JWT (Authorization: Bearer …) or the Clerk __session cookie (browser sessions). See Authentication.

Restores the plate rows changed by one recorded plate update on a job you can write to. With no body it takes the most recent event in the job's plate history; pass eventId to take a specific event. For each well the event changed, the well is set back to the compound, volume and concentration the event recorded as its previous values, or to empty when it recorded none.

The event stays in the plate history, so sending the same request again applies the same restore again. Only events of type plate_update can be undone. A project viewer cannot use this route.

Request

Path parameters

jobIdstring (uuid)

Job UUID.

Request body

eventIdstring

The event_id of the plate-history event to undo. Defaults to the most recent event.

Responses

`200` OK

The event was undone

Response shape:

successenum (true)

undone_event_idstring

The event_id of the event that was restored, or null when the event has none

`400` Bad Request

The job id is empty, or the chosen event is not a plate update that can be undone

Response shape: object

`401` Unauthorized

Authentication required

Response shape: object

`404` Not Found

The job does not exist, you cannot write to it (a project viewer cannot), or it is outside your API key's project scope; or the job has no stored manifest, the manifest cannot be read, it has no plate history, or eventId matches no event. The message says which of the last cases.

Response shape: object

curl -X POST 'https://ivybiosciences.com/api/v1/jobs/{jobId}/undo' \
  -H "Authorization: Bearer $IVY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{}'

POST /v1/jobs/{jobId}/undo

Request

Path parameters

Request body

Responses

`200` OK

`400` Bad Request

`401` Unauthorized

`404` Not Found

`405`

`429` Too Many Requests

`500` Internal Server Error