Use a controlled receiver only
The production test used a temporary listener on 127.0.0.1. Registration failed before any payload was sent, and the listener was stopped.
Read only the documented direction
armaraos webhooks create <AGENT> <URL>
armaraos webhooks test <ID>
Help calls the URL a callback and says test sends a payload. Do not infer more about event direction until end-to-end evidence exists.
Choose a receiver you control
Use a temporary listener on loopback or a request-capture endpoint you own. Never target production or somebody else's system.
Verify state before retrying
armaraos webhooks create <UUID> <CONTROLLED_URL>
armaraos webhooks list --json
The documented form failed with Invalid trigger pattern and the list stayed empty. Do not retry variants against an outside URL or invent an ID.
Keep live-send semantics explicit
armaraos webhooks test <ID>
When registration works in a future build, test is a real send. Confirm the exact ID and watch the controlled receiver. This build never reached that step.
Preserve the deletion boundary
armaraos webhooks delete <ID>
Deletion is permanent and has no dry run. No registration ID existed in this verification, so no delete command was staged.
Carry the production checklist
- Receiver owned and temporary.
- Exact UUID and URL reviewed.
- Registration visible in JSON.
- One test payload visible at the receiver.
- Exact registration deleted and absence verified.
Check it / read actual state
Do not test without an ID.
armaraos webhooks list --json
On the verified build, confirm the list is empty and explain why no payload test follows without a real registration.
Webhook test is a live outbound action when a registration exists. Never aim it at production, a colleague's system, or a URL whose owner and retention policy you do not know.
Troubleshooting for this sitting
| What you see | Likely cause | What to do |
|---|---|---|
| Invalid trigger pattern | Verified 0.8.3 registration defect. | Stop and preserve version details. |
| List is empty | No registration exists. | Do not test or delete an invented ID. |
| Receiver sees nothing | Registration or send did not complete. | Inspect list and result first. |
| URL ownership is unclear | The destination is unsafe. | Do not register it. |