Skip to main content
POST
/
api
/
processes
Get processes (prompts) for a selected user
curl --request POST \
  --url https://your-instance.example.com/api/processes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "selectedUser": {
    "userId": "65b1f0a2c3d4e5f6a7b8c9d0"
  }
}
'
{
  "message": "Processes fetched successfully",
  "processes": [
    {
      "_id": "65b2a1c3d4e5f6a7b8c9d0e1",
      "name": "Lead qualification",
      "prompt": "You are a friendly intake specialist...",
      "responseTime": 5,
      "isHidden": false,
      "temperature": 0.4,
      "createdBy": "65b1f0a2c3d4e5f6a7b8c9d0",
      "organizationId": "65a0e0e0e0e0e0e0e0e0e0e0",
      "createdAt": "2026-04-01T10:00:00.000Z",
      "updatedAt": "2026-05-15T18:24:11.000Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
selectedUser
object
required

User _id whose prompts/processes the caller wants to read (admin-scoped).

Response

Processes fetched successfully

Response from GET /api/processes and POST /api/processes.

​
processes
object[]
required

The user's populated prompts. May be empty when the user has none assigned.

​
message
string