---
title: "Creates a new process in the pending state"
method: POST
path: "/v1/org/{orgId}/process"
tags: ["process"]
---

# Creates a new process in the pending state

`POST /v1/org/{orgId}/process`

## Path parameters

- `orgId` string, required

## Request body

- CreateProcess
  - `orgId` string, required — parent org id
  - `label` string, required — human-readable label that identifies this process
  - `type` string, required — process type
  - `status` 'PENDING' | 'RUNNING' | 'DONE' | 'ERROR', required — current status of process
  - `filePath` string — data file path
  - `runUserId` string, required — user id who is running the process
  - `parentProcessId` string — process id of parent process
  - `message` string — status or error message
  - `progress` number, double — percent progress so far
  - `internalError` string — internal-only error message
  - `options` object, required — 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
  - `uuid` string — unique ID of the process at queue time

## Response `201`

Process created

- Process
  - `id` string, required — globally unique id
  - `orgId` string, required — parent org id
  - `label` string, required — human-readable label that identifies this process
  - `type` string, required — process type
  - `status` 'PENDING' | 'RUNNING' | 'DONE' | 'ERROR', required — current status of process
  - `filePath` string — data file path
  - `logPath` string — data log path
  - `runUserId` string, required — user id who is running the process
  - `parentProcessId` string — process id of parent process
  - `createId` string, required — created by user id (user who requested the process run)
  - `createBehalfId` string — created on behalf of user id
  - `createAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `createAt` string, required — created timestamp
  - `updateId` string — last updated by user id
  - `updateBehalfId` string — last updated on behalf of user id
  - `updateAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `updateAt` string — last updated timestamp
  - `startAt` string — started at timestamp
  - `endAt` string — ended at timestamp
  - `message` string — status or error message
  - `progress` number, double — percent progress so far
  - `internalError` string — internal-only error message
  - `options` object, required — 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
  - `uuid` string — unique ID of the process at queue time

## 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)