Feature · Organization
Workers
See your workers and their current work.
How it works
What a worker is
A worker is an AI employee. Each worker has:
- a name and a handle, for example
@ceo. You mention a worker by its handle; - a role, which gives its instructions and capabilities. See Roles;
- a level, from L0 to L5. See Levels and evaluations;
- a brain: the models it thinks with;
- a manager: the worker it reports to. The CEO reports to you;
- budgets and working hours.
The Workers page
Workers lists every worker as cards or a table. Filter by name or handle, role, status, level and activity.
Statuses
- Onboarding: the worker is being set up. Its work waits.
- Active: it takes work.
- Paused: it takes no new work. An active step may finish first.
- Retired: it no longer works. Its reports move to its manager.
A worker's page
Open a worker to see its tabs: Profile, Work, Activity, Performance, Quality, Memory, Lessons, Brain, Governance and History. Select Message to write to it. An admin can select Edit, Pause, Resume or Retire. See Worker settings.
Who can do what
Members can message workers and give them work. Only an owner or an admin can create, edit, pause or retire a worker.
From the help article Workers, checked against the product on .
What you can do
The operations this feature's screens call. Each one is POST /api/<name>, and the badge says who may call it.
ViewerlistWorkersLists workers.
Types:
ListWorkersRequestreturnsListResponse<WorkerSummary>
ViewerlistWorkItemsLists work items.
Types:
ListWorkItemsRequestreturnsPageResponse<WorkItemSummary>
MemberNo API tokensstartDirectThreadThe same human↔worker thread the internal connector uses when the worker writes first.
Types:
StartDirectThreadRequestreturnsStartDirectThreadResponse
ViewergetThreadGets the thread.
Types:
GetThreadRequestreturnsGetThreadResponse
MemberpostMessagePosts the message.
Types:
PostMessageRequestreturnsMessageDto
ViewerlistRolesLists roles.
Types:
EmptyRequestreturnsListResponse<RoleDto>
AdminpreviewWorkerConfigurationPreviews worker configuration.
Types:
CreateWorkerRequestreturnsWorkerConfigurationPreviewDto
AdmincreateWorkerCreates a worker.
Types:
CreateWorkerRequestreturnsWorkerDetail
AdminstartOnboardingStarts onboarding.
Types:
StartOnboardingRequestreturnsQueuedResponse
ViewerlistProvidersLists providers.
Types:
EmptyRequestreturnsListProvidersResponse
ViewergetOrgBrainDefaultsGets org brain defaults.
Types:
EmptyRequestreturnsOrgBrainDefaultsResponse
ViewergetWorkerGets the worker.
Types:
GetWorkerRequestreturnsGetWorkerResponse
AdminsetWorkerStatusSets worker status.
Types:
SetWorkerStatusRequestreturnsWorkerDetail
ViewerlistWorkerActivityLists worker activity.
Types:
ListWorkerActivityRequestreturnsPageResponse<AuditEvent>
AdminupdateWorkerUpdates the worker.
Types:
UpdateWorkerRequestreturnsWorkerDetail
AdminsetWorkerRoutingOverrideSets the worker routing override.
Types:
SetWorkerRoutingOverrideRequestreturnsWorkerDetail
ViewergetEmployeeProgramGets the employee program.
Types:
{ workerId: string }returnsEmployeeProgram
AdminsetEmployeeInitiativeSets the employee initiative.
Types:
{ workerId: string; expectedRevision: number; initiative: EmployeeProgram['initiative'] }returnsEmployeeProgram
AdminstartEmployeeTrialStarts the employee trial.
Types:
{ workerId: string }returnsEmployeeProgram
AdmindecideEmployeeTrialDecides the employee trial.
Types:
{ workerId: string; decision: 'keep' | 'decline' }returnsEmployeeProgram
ViewerlistConnectorsLists connectors.
Types:
EmptyRequestreturnsListResponse<ConnectorDto>
ViewersimulatePolicySimulates policy.
Types:
SimulatePolicyRequestreturnsSimulatePolicyResponse
ViewergetWorkerSpecHistoryGets worker spec history.
Types:
GetWorkerSpecHistoryRequestreturnsListResponse<WorkerSpecVersionDto>
ViewerlistLessonsLists lessons.
Types:
ListLessonsRequestreturnsListResponse<LessonDto>
ApproverNo API tokensreviewLessonReviews the lesson.
Types:
ReviewLessonRequestreturnsLessonDto
ViewerlistMemoriesLists memories.
Types:
ListMemoriesRequestreturnsPageResponse<MemoryDto>
MemberNo API tokenscreateMemoryCreates memory.
Types:
CreateMemoryRequestreturnsCreateMemoryResponse
ViewergetWorkerMetricsGets worker metrics.
Types:
GetWorkerMetricsRequestreturnsWorkerMetricsSummary
ViewerlistLevelChangesLists level changes.
Types:
ListLevelChangesRequestreturnsListResponse<LevelChangeDto>
ViewerlistEvaluationsLists evaluations.
Types:
ListEvaluationsRequestreturnsListResponse<EvaluationDto>
ViewergetTeamPauseGets the team pause.
Types:
import('./oversight.js').TeamPauseRequestreturnsimport('./oversight.js').TeamPauseDto
AdminNo API tokenspauseTeamPauses the team.
Types:
import('./oversight.js').PauseTeamRequestreturnsimport('./oversight.js').PauseTeamResponse
AdminNo API tokensresumeTeamResumes the team.
Types:
import('./oversight.js').ResumeTeamRequestreturnsimport('./oversight.js').ResumeTeamResponse
ViewergetWorkerQualityGets worker quality.
Types:
GetWorkerQualityRequestreturnsWorkerQualityDto
ViewerlistWorkerTrainingPlansLists worker training plans.
Types:
ListWorkerTrainingPlansRequestreturnsListResponse<WorkerTrainingPlanDto>
MemberproposeWorkerTrainingPlanProposes a worker training plan.
Types:
ProposeWorkerTrainingPlanRequestreturnsWorkerTrainingPlanDto
AdminNo API tokensdecideWorkerTrainingChangeDecides the worker training change.
Types:
DecideWorkerTrainingChangeRequestreturnsWorkerTrainingPlanDto
ViewergetOrgConfigGets org config.
Types:
GetOrgConfigRequestreturnsOrgConfigView
AdminunsetOrgConfigClears org config.
Types:
UnsetOrgConfigRequestreturnsOrgConfigView
AdminsetOrgConfigSets org config.
Types:
SetOrgConfigRequestreturnsOrgConfigView
ViewergetOutreachSettingsGets outreach settings.
Types:
Record<string, never>returnsOutreachSettingsView
AdminsaveOutreachSettingsSaves outreach settings.
Types:
SaveOutreachSettingsRequestreturnsOutreachSettingsView
ViewergetWorkerModelPolicyGets worker model policy.
Types:
GetWorkerModelPolicyRequestreturnsWorkerModelPolicyResponse
AdminNo API tokenssetWorkerModelPolicySets worker model policy.
Types:
SetWorkerModelPolicyRequestreturnsWorkerModelPolicyResponse
AdminNo API tokensdecideLevelChangeDecides the level change.
Types:
DecideLevelChangeRequestreturnsLevelChangeDto
AdminrehearseWorkerRehearses the worker.
Types:
RehearseWorkerRequestreturnsWorkerReadinessDto
AdminNo API tokensgoLiveAnywayGoes the live anyway.
Types:
GoLiveAnywayRequestreturnsWorkerReadinessDto
ViewergetReviewStatsGets review stats.
Types:
{ scope?: ReviewScope; scopeId?: string; reviewerWorkerId?: string; days?: number }returns{ since: string; participants: ReviewParticipantStatsDto[] }
ViewergetExecutionProfileGets the execution profile.
Types:
{ workerId?: string }returnsimport('./execution.js').ExecutionProfileDto
ViewergetTaskMetricsGets task metrics.
Types:
GetTaskMetricsRequestreturnsTaskMetricsResponse
ViewergetWorkerInsightsGets worker insights.
Types:
GetWorkerInsightsRequestreturnsWorkerInsightsResponse
AdminNo API tokensupdateOrgExecutionProfileUpdates the org execution profile.
Types:
{ policy: import('./execution.js').ExecutionPolicyInput }returnsimport('./execution.js').ExecutionProfileDto
AdminNo API tokensupdateDelegateSettingsUpdates delegate settings.
Types:
UpdateDelegateSettingsRequestreturnsDelegateSettingsDto
ViewerlistWorkItemDelegatesLists work item delegates.
Types:
ListWorkItemDelegatesRequestreturnsWorkItemDelegatesDto
ViewerlistMembersLists members.
Types:
EmptyRequestreturnsListMembersResponse
Screens
/workers/workers/:id
What it records
The feature writes these events to the audit log, the permanent record of what happened.
- Approval expired
- Approval received
- Integration changed
- Policy changed
- Action denied
- Delegate ended
- Effort baseline changed
- Employee initiative configured
- Employee initiative created
- Employee initiative proposed
- Employee trial decision changed
- Employee trial started