AiOrg
An AI organization: its state, live revision, pause epoch, consent and today's spend.
Shape
- created_atstring · date-time
created_byActorSummary
- The ActorSummary schema
- emailstring
- idstring
- usernamestring
- avatar_urlstring or nulloptional
- group_idGroupId (string · uuid)The root group the organization is attached to.
- nameAiOrgName (string)
- org_idAiOrgId (string · uuid)
- originAiOrgOrigingreenfieldadoptHow an organization came to be: the setup wizard, or joining what already exists.
- pause_epochinteger · int64Incremented by every pause.
- regionAiRegioneuusWhere an organization's model calls are served, and so where its content is processed. Fixed when the organization is created.
- spend_today_microsinteger · int64Usage and fees charged so far today (UTC), in micro-dollars.
- stateAiOrgStatedraftprovisioninglivepausedretiredAn organization's lifecycle:
draft→provisioning→live⇄paused→retired. - updated_atstring · date-time
- consented_atstring · date-time or nulloptional
consented_byActorSummary or nulloptionalWho accepted that the organization's content goes to the model provider, and when. No model call is made without it.
- The ActorSummary schema
- emailstring
- idstring
- usernamestring
- avatar_urlstring or nulloptional
- live_revisioninteger · int64 or nulloptionalThe number of the revision in force, absent until the first publish.
Example
Synthesized example{
"created_at": "2026-10-12T04:19:25Z",
"created_by": {
"email": "lin@acme.example",
"id": "id-22fc",
"username": "tomas",
"avatar_url": "https://gitmoap.example/acme/8ef2d483"
},
"group_id": "4c1d8e2f-6a3b-4f90-b7c5-1e2d3c4b5a69",
"name": "payments-api",
"org_id": "6821faf5-2a7f-4f83-81c4-84031dd5143c",
"origin": "greenfield",
"pause_epoch": 15,
"region": "eu",
"spend_today_micros": 9,
"state": "draft",
"updated_at": "2026-10-10T11:58:32Z",
"consented_at": "2026-10-09T06:21:52Z",
"consented_by": {
"email": "mara@acme.example",
"id": "id-7586",
"username": "lin",
"avatar_url": "https://gitmoap.example/acme/d89d2ed8"
},
"live_revision": 28
}
Graph
Used inside
No schema contains this one.
Contains
Used by
Sent by 0 operations
No operation takes it as a request body.
Returned by 6 operations
- GETAn AI organization: its state, live revision, pause epoch, consent and today's spend./groups/{group_id}/ai-org
- POSTCreate the AI organization of a top-level group, in draft./groups/{group_id}/ai-org
- POSTAccept that the organization's content is sent to the model provider in its region./groups/{group_id}/ai-org/consent
- DELWithdraw consent: no model call is made from now on, and a live organization pauses./groups/{group_id}/ai-org/consent
- POSTPause the organization: every agent stops at once./groups/{group_id}/ai-org/pause
- POSTResume the organization: halted sessions continue./groups/{group_id}/ai-org/resume