v3

latestSwagger 2.02026-08-067506752.0 MB

process

Creates a new process with a specified createId in the pending state

post/v1/org/{orgId}/process/{createIdOverride}

Path parameters

orgIdstring required

Org identifier (either id or slug)

createIdOverridestring required

created user id override

Request body

orgIdstring required

parent org id

labelstring required

human-readable label that identifies this process

typestring required

process type

status'PENDING' | 'RUNNING' | 'DONE' | 'ERROR' required

current status of process

filePathstring

data file path

runUserIdstring required

user id who is running the process

parentProcessIdstring

process id of parent process

messagestring

status or error message

progressnumber double

percent progress so far

internalErrorstring

internal-only error message

optionsobject required

options passed to the process

resultsobject

results summary for the process

stateobject

process-specific state data

summarystring

human-readable, searchable summary of what this process did

appIdstring

app id of the process

uuidstring

unique ID of the process at queue time

Example request

{
  "orgId": "588f7ee98f138b19220041a7",
  "runUserId": "588f7ee98f138b19220041a7",
  "parentProcessId": "588f7ee98f138b19220041a7",
  "logDataList": [
    {
      "at": "2017-01-24T13:57:52Z"
    }
  ],
  "appId": "588f7ee98f138b19220041a7",
  "uuid": "84db3c6e-0877-4436-8af1-768c06b29586"
}

Response

Process created

idstring required

globally unique id

orgIdstring required

parent org id

labelstring required

human-readable label that identifies this process

typestring required

process type

status'PENDING' | 'RUNNING' | 'DONE' | 'ERROR' required

current status of process

filePathstring

data file path

logPathstring

data log path

runUserIdstring required

user id who is running the process

parentProcessIdstring

process id of parent process

createIdstring required

created by user id (user who requested the process run)

createBehalfIdstring

created on behalf of user id

createAtstring required

created timestamp

updateIdstring

last updated by user id

updateBehalfIdstring

last updated on behalf of user id

updateAtstring

last updated timestamp

startAtstring

started at timestamp

endAtstring

ended at timestamp

messagestring

status or error message

progressnumber double

percent progress so far

internalErrorstring

internal-only error message

optionsobject required

options passed to the process

resultsobject

results summary for the process

stateobject

process-specific state data

summarystring

human-readable, searchable summary of what this process did

appIdstring

app id of the process

uuidstring

unique ID of the process at queue time

Example response

{
  "id": "588f7ee98f138b19220041a7",
  "orgId": "588f7ee98f138b19220041a7",
  "runUserId": "588f7ee98f138b19220041a7",
  "parentProcessId": "588f7ee98f138b19220041a7",
  "createId": "588f7ee98f138b19220041a7",
  "createBehalfId": "588f7ee98f138b19220041a7",
  "createAttribution": {
    "principalUserId": "588f7ee98f138b19220041a7",
    "agentUserIds": [
      "588f7ee98f138b19220041a7"
    ],
    "eventId": "588f7ee98f138b19220041a7",
    "aiChatId": "588f7ee98f138b19220041a7"
  },
  "createAt": "2017-01-24T13:57:52Z",
  "updateId": "588f7ee98f138b19220041a7",
  "updateBehalfId": "588f7ee98f138b19220041a7",
  "updateAttribution": {
    "principalUserId": "588f7ee98f138b19220041a7",
    "agentUserIds": [
      "588f7ee98f138b19220041a7"
    ],
    "eventId": "588f7ee98f138b19220041a7",
    "aiChatId": "588f7ee98f138b19220041a7"
  },
  "updateAt": "2017-01-24T13:57:52Z",
  "startAt": "2017-01-24T13:57:52Z",
  "endAt": "2017-01-24T13:57:52Z",
  "logDataList": [
    {
      "at": "2017-01-24T13:57:52Z"
    }
  ],
  "appId": "588f7ee98f138b19220041a7",
  "uuid": "84db3c6e-0877-4436-8af1-768c06b29586"
}