Update latest.yaml to add group repo access (#22369)

Adding API documentation for assign a group (Team) to a repository for
access

<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Sarah Sanders <sarah.sanders@docker.com>
This commit is contained in:
sheltongraves 2025-04-08 14:03:55 -04:00 committed by GitHub
parent 902dcc0f13
commit 6f45356dde
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 50 additions and 0 deletions

View File

@ -892,6 +892,42 @@ paths:
$ref: "#/components/responses/Forbidden" $ref: "#/components/responses/Forbidden"
"404": "404":
$ref: "#/components/responses/NotFound" $ref: "#/components/responses/NotFound"
/v2/repositories/{namespace}/{repository}/groups:
parameters:
- $ref: "#/components/parameters/namespace"
- $ref: "#/components/parameters/repository"
post:
summary: Assign a group (Team) to a repository for access
tags:
- repositories
security:
- bearerAuth: []
parameters:
- in: query
name: group_name
required: true
schema:
type: string
description: Name of the group (team) in the organization.
- in: query
name: permission
required: true
schema:
type: string
description: |
Access level for the group. Possible values:
- `read`
- `write`
- `admin`
responses:
"200":
$ref: "#/components/responses/team_repo"
"403":
$ref: "#/components/responses/forbidden"
"404":
$ref: "#/components/responses/NotFound"
/v2/orgs/{org_name}/members: /v2/orgs/{org_name}/members:
parameters: parameters:
- $ref: "#/components/parameters/org_name" - $ref: "#/components/parameters/org_name"
@ -3087,6 +3123,20 @@ components:
description: Resources this token has access to description: Resources this token has access to
items: items:
$ref: "#/components/schemas/orgAccessTokenResource" $ref: "#/components/schemas/orgAccessTokenResource"
team_repo:
allOf:
- $ref: "#/components/responses/team_repo"
properties:
group_name:
type: string
description: Name of the group
permission:
type: string
description: Repo access permission
enum:
- read
- write
- admin
parameters: parameters:
namespace: namespace:
in: path in: path