Vera.AI / Developer Docs
llms.txt

Review and autonomy

Let Vera continue safe work without hiding human gates.

Project policy controls how much Vera can continue on its own. Autonomous mode can prepare safe work, but blockers and hard stops still surface to the external agent.

Policy

Choose the operating mode per project.

Use `needs_approval` for human-in-the-loop operation. Use `autonomous` only when Vera should continue safe preparation and permitted sends under project policy.

Project policy
$ curl -X PATCH https://api-vera.symph.ai/v1/projects/proj_01hx6x9v2r/policy \
>   -H "Authorization: Bearer vwk_live_..." \
>   -H "Content-Type: application/json" \
>   -d '{ "agent_mode": "autonomous" }'

Decisions

Approve, skip, retry, or request changes.

Review decisions are the clean way to move research, strategy, and drafts forward. They also preserve reviewer notes for replacement or focused revision runs.

Review decision
$ curl -X POST https://api-vera.symph.ai/v1/projects/proj_01hx6x9v2r/review-decisions \
>   -H "Authorization: Bearer vwk_live_..." \
>   -H "Content-Type: application/json" \
>   -d '{
>     "target_type": "draft",
>     "target_id": "draft_01hx8cb9ja",
>     "decision": "request_changes",
>     "note": "Shorten the opener and remove the pricing reference."
>   }'

Continue

Advance the next safe preparation step.

`agent:continue` reconciles autonomous work, avoids duplicate active prep runs, queues available work, or returns blockers when review is required.

Agent continue
$ curl -X POST "https://api-vera.symph.ai/v1/projects/proj_01hx6x9v2r/agent:continue?max_runs=4" \
>   -H "Authorization: Bearer vwk_live_..."

Hard stops

  • No approved seller knowledge or source evidence for the claim the agent wants to use.
  • Gmail is disconnected, the selected sender is unverified, or readiness reports blockers.
  • A prospect asks to unsubscribe, stop, talk to a human, discuss pricing, or handle a sensitive objection.
  • A draft has safety flags, unclear citations, rejected claims, or a lifecycle status other than ready_to_send.
  • The project is in needs_approval mode and the next item has not been approved through review decisions.