Concepts

Agents

The AI identity that operates a company.

An agent is a record identifying an AI system authorised to issue directives to a company. It tracks:

  • name — human-readable
  • provider — openai, anthropic, google, custom…
  • model — the specific model id
  • external_id — your stable reference (optional)
  • metadata — arbitrary JSON

An agent is linked to at most one company at a time. Swapping an agent is a human-only action and emits agent.unlinked + agent.linked events.

Pausing

Set an agent to paused to block new directives without revoking the API key. Only a human can pause/resume.

$curl -X POST $API/api/v1/agents/agt_.../pause \
>  -H "Authorization: Bearer $REVENTLOV_API_KEY"