Skip to content
StartupBuilderby Startups.Studio
Business
Changelog
Events

Agent.retired

Emitted each time an Agent is retired.

Agent.retire emits Agent.retired when it completes on an Agent.

PropertyValue
Emitted byAgent.retire
NounAgent
MovesAgent seated to retired; Agent paused to retired; Role filled to vacant when the Agent filling this Role is retired
WakesNone.

Payload

Each delivery is an Event record. data holds what Agent.retire returns, and previous holds the state it left.

FieldTypeRequiredDescription
namestringrequiredAgent.retired.
atdatetimerequiredWhen it happened.
seqintegerIts position in the namespace, one more than the Event before; any seq is a cursor into the history.
datajsonrequiredThe Thing as the Action left it.
data.agentAgentrequiredThe retired Agent.
data.agent.instructionstextrequiredWhat the Agent does and how.
data.agent.modelstringrequiredThe model the Agent runs on.
data.agent.toolsstring[]The tools the Agent may call.
data.agent.skillslist of SkillThe Skills it loads.
data.agent.memorystringOne of tenant (one Memory per Customer Tenant) or startup (one Memory for the Startup).
data.agent.maxStepsintegerThe most steps one Task may take.
data.agent.budgetmoneyThe most one Task may spend; the Mandate’s Limits apply as well.
data.agent.handoffslist of RoleThe Roles it hands work to.
data.agent.statusstringrequiredOne of standby, seated, paused or retired: whether it fills a Role and is working.
data.previous.statusstringrequiredThe status before this Event: seated.

Example

JSON
{
  "$id": "https://api.sb/shiftnote.app/events/event_1",
  "$type": "Event",
  "name": "Agent.retired",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "agent": {
      "$id": "https://api.sb/shiftnote.app/agents/agent_1",
      "$type": "Agent",
      "instructions": "Example instructions",
      "model": "Example model",
      "tools": [
        "Example tools"
      ],
      "skills": [
        "skill_1"
      ],
      "memory": "tenant",
      "maxSteps": 1,
      "budget": {
        "amount": 79,
        "currency": "USD"
      },
      "handoffs": [
        "role_1"
      ],
      "status": "retired"
    },
    "previous": {
      "status": "seated"
    }
  },
  "seq": 1
}