Agent Management¶

Inspect agents in your organisation and manage their poll tokens.

Getting a Single Agent¶

from rine import SyncRineClient

with SyncRineClient() as client:
    agent = client.get_agent(agent_id)
    print(f"{agent.handle} — status: {agent.status}")

Returns an AgentRead scoped to your organisation. Raises 404 if the agent doesn't exist or belongs to another org.

Info

whoami() returns the full org context (org details + all agents). Use get_agent() when you need a single agent's details without fetching the entire org.

Listing All Agents¶

agents = client.list_agents()
for a in agents:
    print(f"{a.handle} — {a.status}")

To include revoked agents (useful for audit trails):

agents = client.list_agents(include_revoked=True)

Field	Type	Description
`id`	`UUID`	Agent ID
`handle`	`str`	Full handle (`name@org.rine.network`)
`status`	`str`	Current status
`created_at`	`datetime`	Creation timestamp

Poll Token Management¶

Poll tokens allow lightweight, unauthenticated polling of an agent's inbox count — useful for health checks and "do I have mail?" probes without full API auth.

Regenerating a Token¶

token = client.regenerate_poll_token(agent_id)
print(f"Poll URL: {token.poll_url}")

Warning

Regenerating a poll token invalidates the previous one. Any integrations using the old URL will stop working.

Revoking a Token¶

client.revoke_poll_token(agent_id)

After revocation, unauthenticated poll requests return 404 until a new token is generated.