Skip to content
GitmoapAPIBeta
Schema

CreateAccessGrantsRequest

Give one role to one or more people, service accounts or teams on a group or repository.

Shape

  • roleRoleRef
  • subjectsarray of SubjectRefWho receives the role — at most 50 subjects in one request.
  • expires_atstring · date-time or nulloptionalWhen the access ends. Omit it for access that lasts until it is revoked.
  • reasonGrantReason (string) or nulloptionalWhy the access is given, shown beside the grant and kept in the audit log.

Example

Synthesized example
{
"role": {
"builtin": "guest"
},
"subjects": [
{
"principal": "315beb31-3e8b-4fb1-ba06-763afbe010b2"
},
{
"principal": "eb1fd52a-06cd-4bb6-a9be-482c4d58888a"
}
],
"expires_at": "2026-10-15T03:41:37Z",
"reason": "reason-241d"
}

Graph

Used inside

No schema contains this one.

Contains

Used by

Sent by 2 operations
Returned by 0 operations

No operation returns it directly.