Create a robot
Creates the workspace that holds one customer's conversations, automation rules and training data. Create the robot before connecting any channel to it.
Put your own customer id in `external_id` and we return it on every webhook event, so you never need a lookup table between our ids and yours.
Each robot consumes one unit of your plan's capacity. Deleting one frees that capacity immediately.
Authentication
AuthorizationBearer
Your API key, issued by ParsChat sales. One key per account, spanning every robot you own. Send it as Authorization: Bearer pk_live_….
Request
This endpoint expects an object.
name
Display name, shown in the panel.
external_id
Your own customer id. Unique across your robots; reusing one returns 409.
Response
The robot was created.
id
ParsChat identifier for the robot.
name
Display name, shown in the panel.
external_id
Your own identifier for this customer. Returned on every webhook event, so you do not need a lookup table.
channels
Channels attached to this robot, in short form. Empty until you connect one. Call the channels endpoint for the full record.
created_at
When the robot was created.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error