AccessReviewItem
One grant in the access review, and why it is there.
Shape
grantAccessGrant
- The AccessGrant schema
- created_atstring · date-time
- grant_idGrantId (string · uuid)
roleRoleView
- The RoleView schema
- namestringThe role's display name: a built-in name such as
Developer, or the custom role's name. - rankAccessLevelguestreporterdevelopermaintainerownerThe built-in rank the role counts as wherever a rank is compared, such as a protected branch's minimum.
- builtinAccessLevelguestreporterdevelopermaintainerowneror nulloptionalSet when the role is built in.
- customRoleId (string · uuid) or nulloptionalSet when the role is one the organization defined.
scopeAccessScopeWhere the grant was made.
- The AccessScope schema
- full_pathstring
- idstring
- typeScopeTypegrouprepository
- subjectGrantSubject
- updated_atstring · date-time
- expires_atstring · date-time or nulloptional
granted_byActorSummary or nulloptionalWho made the grant. Absent for access the platform created — the creator of a group or repository, or a copied membership.
- The ActorSummary schema
- emailstring
- idstring
- usernamestring
- avatar_urlstring or nulloptional
- last_exercised_atstring · date-time or nulloptionalWhen the grant last let somebody do something, to the day. Absent until it has.
- reasonstring or nulloptional
- reasonsarray of AccessReviewReason: one of expiring | sensitive | unused | redundant | outside_collaborator | service_account
covered_byarray of AccessGrantoptionalFor a redundant grant: the grants that already give everything it does, so the reviewer can see why revoking it takes nothing away.
- The AccessGrant schema
- created_atstring · date-time
- grant_idGrantId (string · uuid)
roleRoleView
- The RoleView schema
- namestringThe role's display name: a built-in name such as
Developer, or the custom role's name. - rankAccessLevelguestreporterdevelopermaintainerownerThe built-in rank the role counts as wherever a rank is compared, such as a protected branch's minimum.
- builtinAccessLevelguestreporterdevelopermaintainerowneror nulloptionalSet when the role is built in.
- customRoleId (string · uuid) or nulloptionalSet when the role is one the organization defined.
scopeAccessScopeWhere the grant was made.
- The AccessScope schema
- full_pathstring
- idstring
- typeScopeTypegrouprepository
- subjectGrantSubject
- updated_atstring · date-time
- expires_atstring · date-time or nulloptional
granted_byActorSummary or nulloptionalWho made the grant. Absent for access the platform created — the creator of a group or repository, or a copied membership.
- The ActorSummary schema
- emailstring
- idstring
- usernamestring
- avatar_urlstring or nulloptional
- last_exercised_atstring · date-time or nulloptionalWhen the grant last let somebody do something, to the day. Absent until it has.
- reasonstring or nulloptional
Example
Synthesized example{
"grant": {
"created_at": "2026-10-11T15:22:57Z",
"grant_id": "72cef6e0-c7fa-4ca7-9b59-44667a2ff20b",
"role": {
"name": "payments-api",
"rank": "guest",
"builtin": "guest",
"custom": "799f8248-8540-445f-bd07-88f370080817"
},
"scope": {
"full_path": "acme/payments-api",
"id": "id-745e",
"type": "group"
},
"subject": {
"principal": {
"id": "7fdded33-0285-4d2a-9a51-81d20b5311da",
"kind": "user",
"username": "lin",
"avatar_url": "https://gitmoap.example/acme/c8ab3617"
}
},
"updated_at": "2026-10-16T20:41:39Z",
"expires_at": "2026-10-12T13:32:01Z",
"granted_by": {
"email": "lin@acme.example",
"id": "id-0fd2",
"username": "tomas",
"avatar_url": "https://gitmoap.example/acme/11b7c1d9"
},
"last_exercised_at": "2026-10-13T21:04:47Z",
"reason": "reason-7810"
},
"reasons": [
"expiring",
"expiring"
],
"covered_by": [
{
"created_at": "2026-10-13T09:46:57Z",
"grant_id": "42400df8-8ce3-4c09-a36b-c3f428e7f7f9",
"role": {
"name": "payments-api",
"rank": "guest"
},
"scope": {
"full_path": "acme/payments-api",
"id": "id-90aa",
"type": "group"
},
"subject": {
"principal": {
"id": "999ffa61-bc55-44b6-987e-7727e8d7eb10",
"kind": "user",
"username": "lin"
}
},
"updated_at": "2026-10-10T04:11:06Z"
},
{
"created_at": "2026-10-11T15:36:18Z",
"grant_id": "838ba03c-b8f6-490f-afc9-88d41c4cd282",
"role": {
"name": "payments-api",
"rank": "guest"
},
"scope": {
"full_path": "acme/payments-api",
"id": "id-d00a",
"type": "group"
},
"subject": {
"principal": {
"id": "d4cb4de6-0ff5-4760-8176-b0d2546f53a8",
"kind": "user",
"username": "mara"
}
},
"updated_at": "2026-10-16T07:19:28Z"
}
]
}
Graph
Used inside
Contains
Used by
Sent by 0 operations
No operation takes it as a request body.