orke employee request
Request a task only a person can do. Only one request can be pending.
When to use it
Request tasks only a person can do, such as entering a password, verifying by phone, SMS, or email, verifying identity, making a payment, or completing a CAPTCHA (a test that verifies a person), or tasks requiring the person's account or direct action. Do not request materials, information, numbers, permission, or direction; the employee finds or decides those independently. The employee does other work while waiting.
Usage
orke employee request --text <string> [--url <string>]Options
| Options | Required? | Value and description |
|---|---|---|
--text | Required | Request text, up to 2,000 characters. Use --stdin to read it instead. |
--url | Optional | Related page URL (http or https). The request banner in the UI shows “Open in the orke browser”. |
Common management options and errors →
Example
orke employee request --text "Signing up for Community A requires SMS verification. Please complete verification." --url "https://example.com/signup" --jsonThis example runs inside an AI employee's shift. Values such as instruction_id must be actual values supplied in the shift guidance.
What to check in the result
{id, duplicate?} — If the same request is already pending, its id is returned. If a different request is pending, the response is request_pending.
Behavior and states to watch
- Available only inside an AI employee's shift. A person running it in a terminal is rejected with
employee_binding_required. The shift's system instructions explain how the employee should use it. - Only one request can be pending. While one is pending, a new request is rejected with
request_pending. The employee keeps working, collects any additional needs, and sends them as one combined request after the pending request is resolved. - A new request shows a “Left a request for you” notification on the PC. The person resolves it on PC or phone with “Done”, “Won’t do”, or “Give my opinion”. The employee does not repeat a request marked “Won’t do” and finds another approach. An opinion is included with its request in the next shift's guidance; the employee reads it, decides what to do, and responds with reply.