Skip to content
GitmoapAPIBeta
Schema

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: L1 is engineers in one squad, L2 adds squads each led by a product owner, L3 adds 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
  • triggersTriggerAllowListoptional

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.