Prepare an employee from a message
POSThttps://platform.docana.com/api/v1/employees/:id/prepare-message/
Uses the same employee preparation assistant as the UI. Send a goal or correction; optionally continue a caller-owned preparation thread. Can write drafts, configure connections and run authorized tests. Publishes only after explicit user approval. May take several minutes. With Prefer: respond-async, returns 202 once the brief is saved; the response continues in the returned preparation thread. After a timeout or interrupted write, inspect employee status and thread history before retrying. Enter website credentials through the dedicated login operation or secure form, not the prompt.
Request
Responses
- 200
- 202
- 400
- 401
- 403
- 404
- 500
Preparation reply, conversation ID and tool completion states
Brief saved; preparation continues in the returned thread. Text and tools are initially empty.
The request body, query, or path failed validation. See validationErrors.
The API key or session is missing, expired, or malformed.
The caller is authenticated but not allowed to perform this operation.
A resource referenced by the path does not exist or is not visible to the caller.
Unexpected server error.