mirror of
https://github.com/docker/docs.git
synced 2026-10-25 06:09:46 +03:00
## Summary - Document that member `PUT` `role` accepts a custom role **name**, not only `owner` | `editor` | `member`. - Document `role` on team `PATCH` (core or custom role name) and on `org_group` so the PATCH 200 can include the assigned role. - Add `Editor` to `org_member.role` (title case). Live responses already return it; the old enum was Owner / Member / Invitee only. ## Test plan PM must confirm before merge: - [ ] Member PUT 200: after assigning a custom role (body is not the previous core role), is `role` still a core value (`Owner` / `Editor` / `Member`), or is it the custom role **name**? If it is the custom name, drop the `org_member.role` enum in a follow-up and describe a string (core or custom name). If it stays a core value, this PR's enum (`Owner` | `Editor` | `Member` | `Invitee`) is enough. - [ ] List members: same field. Confirm a user with a custom role lists as a core value vs the custom name. - [ ] Casing: request stays lowercase (`editor`); response stays title case (`Editor`). Confirm that split is real. - [ ] Team PATCH 200: confirm `org_group.role` is present and is the value just set (core or custom name). - [ ] Team assignment is PATCH-only, not PUT. - [ ] Unknown role names return an error; do not document them as valid. - [ ] Custom role **name** (not label or UUID) is the request identifier, matching Docker Home. --------- Co-authored-by: Cursor <cursoragent@cursor.com>
3.2 KiB
3.2 KiB
description, title, linkTitle, keywords, weight, toc_min, toc_max, aliases
| description | title | linkTitle | keywords | weight | toc_min | toc_max | aliases | |
|---|---|---|---|---|---|---|---|---|
| Docker Hub API changelog | Docker Hub API changelog | Changelog | docker hub, hub, whats new, release notes, api, changelog | 2 | 1 | 2 |
|
Here you can learn about the latest changes, new features, bug fixes, and known issues for Docker Service APIs.
2026-09-01
Updates
- Document that Update org member (role)
accepts a custom role name in
role. - Document the
rolefield on Update some details for an organization group. - Add
Editortoorg_member.roleon organization members.
2026-08-27
Updates
- Document organization access token (OAT) support for repository management endpoints, the scope-dependent behavior of List repositories, and legacy paths that are OAT unsupported.
2025-11-21
Updates
- Add missing
expires_atfields on PAT management endpoints.
2025-09-25
Updates
- Fix Assign repository group endpoints request/response
2025-09-19
New
- Add Create repository endpoints for a given
namespace. - Add Get repository endpoints for a given
namespace. - Add Check repository endpoints for a given
namespace.
Deprecations
- Deprecate POST /v2/repositories
- Deprecate POST /v2/repositories/{namespace}
- Deprecate GET /v2/repositories/{namespace}/{repository}
- Deprecate HEAD /v2/repositories/{namespace}/{repository}
2025-07-29
New
- Add Update repository immutable tags settings endpoints for a given
namespaceandrepository. - Add Verify repository immutable tags endpoints for a given
namespaceandrepository.
2025-06-27
New
- Add List repositories endpoints for a given
namespace.
Deprecations
2025-03-25
New
- Add APIs for organization access token (OATs) management.
2025-03-18
New
- Add access to audit logs for org access tokens.