OrgConfig
An organization's whole configuration: its shape and board, agents, squads, autonomy, budgets, models, tracker, who may wake an agent and how pipelines treat agent-written code.
Shape
autonomyAutonomyConfig
- The AutonomyConfig schema
- levelAutonomyLevelsupervisedgatedautonomousHow much an organization may do without asking: a named preset for every gate, each of which can still be set on its own.
gatesarray of GateOverrideoptional
- The GateOverride schema
- gateAiGateKindmerge_protectedmerge_unprotectedlarge_changeadd_dependencycreate_work_itemclose_work_itemreleasedeploy_non_productiondeploy_productionexternal_messagesession_spendprivileged_pathritual_outcomeA kind of action an organization's autonomy decides whether an agent may take without asking.
- settingGateSettingasknotifyallowWhat a gate does when its action comes up, from strictest to loosest: wait for a person, go ahead and tell the approvers, or go ahead.
budgetsBudgets
- The Budgets schema
- org_monthly_cap_microsinteger · int640–∞All model usage and fees of the organization per calendar month in UTC. Required.
- agent_daily_cap_microsinteger · int64 or nulloptional0–∞
- session_cap_microsinteger · int64 or nulloptional0–∞
structureOrgStructure
- The OrgStructure schema
- levelStructureLevelL1L2L3The organization's shape:
L1is engineers in one squad,L2adds squads each led by a product owner,L3adds a director across the squads. - boardarray of UserId (string · uuid)optionalBesides the root group's Owners, who are always on it.
agentsarray of AgentConfigoptional
- The AgentConfig schema
- display_nameAgentDisplayName (string)
- handleAgentHandle (string)
- keyAgentKey (string)
- positionPositionengineerreviewerproduct_ownerdirectorrelease_managertechnical_writerAn agent's job, which decides what it may do and which model tier it uses by default.
- squadSquadKey (string)
profileAgentProfileoptional
- The AgentProfile schema
- model_tierAiModelTiermost_capablestandardeconomicalor nulloptionalOverrides the position's tier for this agent.
- personaAgentPersona (string) or nulloptional
- specialisationSpecialisationbackendfrontendinfrastructurecli_and_toolingqualityor nulloptionalAn engineer's specialisation, which shapes the work it is given.
- wip_limitinteger · int32 or nulloptional0–∞
modelsarray of PositionRoutingoptionalPinned.
- The PositionRouting schema
- positionPositionengineerreviewerproduct_ownerdirectorrelease_managertechnical_writerAn agent's job, which decides what it may do and which model tier it uses by default.
- tierAiModelTiermost_capablestandardeconomicalA model tier: the most capable, the standard, or the economical model in the organization's region.
- modelAiModelKey (string) or nulloptionalAn exact model, which stays exact until the provider retires it.
pipelinesPipelinePolicyoptionalOrdered.
- The PipelinePolicy schema
- agent_codeAgentCodeTrustuntrustedtrustedoptionalWhether a run of code an agent wrote, or a run an agent started, gets the repository's connections, secrets, cloud roles and build cache.
squadsarray of SquadConfigoptional
- The SquadConfig schema
- keySquadKey (string)
- leadAgentKey (string)
- nameSquadName (string)
- repositoriesarray of RepositoryId (string · uuid)optional
trackerTrackerConfigoptional
- The TrackerConfig schema
- kindAiTrackergitmoapjiratrello
triggersTriggerAllowListoptional
- The TriggerAllowList schema
- principalsarray of PrincipalId (string · uuid)optional
Example
Synthesized example{
"autonomy": {
"level": "supervised",
"gates": [
{
"gate": "merge_protected",
"setting": "ask"
}
]
},
"budgets": {
"org_monthly_cap_micros": 32,
"agent_daily_cap_micros": 1,
"session_cap_micros": 52
},
"structure": {
"level": "L1",
"board": [
"b7e2d1c0-9f8e-4d7c-a6b5-c4d3e2f1a0b9",
"c9d8e7f6-a5b4-4c3d-9e2f-1a0b9c8d7e6f"
]
},
"agents": [
{
"display_name": "Tomás Reyes",
"handle": "handle-8154",
"key": "key-ba25",
"position": "engineer",
"squad": "squad-1f95"
},
{
"display_name": "Tomás Reyes",
"handle": "handle-fd9e",
"key": "key-d81c",
"position": "engineer",
"squad": "squad-09b4"
}
],
"models": [
{
"position": "engineer",
"tier": "most_capable"
},
{
"position": "engineer",
"tier": "most_capable"
}
],
"pipelines": {
"agent_code": "untrusted"
},
"squads": [
{
"key": "key-ca26",
"lead": "lead-80b7",
"name": "payments-api"
}
],
"tracker": {
"kind": "gitmoap"
},
"triggers": {
"principals": [
"c1870ac4-fce7-42c4-8743-3698b9229fde",
"a24fa017-d8ee-4751-8cf8-04a3857659f8"
]
}
}
Graph
Used by
Sent by 0 operations
No operation takes it as a request body.
Returned by 0 operations
No operation returns it directly.