Skip to main content

​
Agents

An agent is a named identity in Anima. Each agent gets its own email address, phone number, vault, and virtual cards — everything a real person needs to operate autonomously. You interact with all other Anima resources through an agent.

​
Agent IDs and API keys

Every agent is assigned an ID with the prefix ag_ (for example, ag_01abc123). You use this ID when calling any resource scoped to a specific agent — sending email, provisioning a phone number, or accessing the vault. Your Anima API key uses the prefix ak_. Pass it when initializing the SDK client.

​
Install the SDK

pip install anima-labs

​
Initialize the client

from anima import Anima

anima = Anima(api_key="ak_...")

​
Create an agent

agent = anima.agents.create(name="Support Bot")
print(f"Agent ID: {agent.id}")  # ag_...
Once created, the agent has an email inbox provisioned automatically. You can provision a vault, phone number, and virtual cards separately.

​
List agents

agents = anima.agents.list()
for a in agents:
    print(f"{a.id}  {a.name}")

​
Get an agent

agent = anima.agents.get(agent_id="ag_01abc123")
print(agent.name)

​
Delete an agent

anima.agents.delete(agent_id="ag_01abc123")
Deleting an agent is permanent. All associated email messages, vault credentials, and phone numbers are removed. Release phone numbers and deprovision the vault before deleting if you need to preserve data elsewhere.

​
Next steps

  • Email — Send and receive email from your agent
  • Vault — Store credentials securely
  • Phone — Provision phone numbers and send SMS