---
title: "Update the status of a process, marking its progress or setting status to DONE or ERROR"
method: PATCH
path: "/v1/org/{orgId}/process/{processId}"
tags: ["process"]
---

# Update the status of a process, marking its progress or setting status to DONE or ERROR

`PATCH /v1/org/{orgId}/process/{processId}`

## Path parameters

- `orgId` string, required
- `processId` string, required

## Request body

- UpdateProcess
  - `status` 'PENDING' | 'RUNNING' | 'DONE' | 'ERROR' — current status of process
  - `filePath` string — data file path
  - `message` string — status or error message
  - `progress` number, double — percent progress so far
  - `internalError` string — internal-only error message
  - `options` object — options passed to the process
  - `results` object — results summary for the process
  - `logDataList` LogData[] — list of log data that occurred during running of this process
    - `level` 'INFO' | 'WARN' | 'ERROR', required
    - `at` string, required — created timestamp
    - `message` string
    - `data` object, required
  - `state` object — process-specific state data
  - `summary` string — human-readable, searchable summary of what this process did
  - `appId` string — app id of the process

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/versions/50a1edd6b27e/schema)