7878 $ref : " #/components/responses/Unauthenticated"
7979 " 403 " :
8080 $ref : " #/components/responses/PermissionDenied"
81+ " 404 " :
82+ $ref : " #/components/responses/NotFound"
8183 " 500 " :
8284 $ref : " #/components/responses/InternalError"
8385
@@ -124,6 +126,8 @@ paths:
124126 $ref : " #/components/responses/Unauthenticated"
125127 " 403 " :
126128 $ref : " #/components/responses/PermissionDenied"
129+ " 404 " :
130+ $ref : " #/components/responses/NotFound"
127131 " 409 " :
128132 $ref : " #/components/responses/Conflict"
129133 " 500 " :
@@ -249,6 +253,8 @@ paths:
249253 $ref : " #/components/responses/PermissionDenied"
250254 " 404 " :
251255 $ref : " #/components/responses/NotFound"
256+ " 409 " :
257+ $ref : " #/components/responses/Conflict"
252258 " 500 " :
253259 $ref : " #/components/responses/InternalError"
254260
@@ -310,6 +316,8 @@ paths:
310316 $ref : " #/components/responses/PermissionDenied"
311317 " 404 " :
312318 $ref : " #/components/responses/NotFound"
319+ " 409 " :
320+ $ref : " #/components/responses/Conflict"
313321 " 500 " :
314322 $ref : " #/components/responses/InternalError"
315323
@@ -353,11 +361,11 @@ components:
353361 bearerFormat : JWT
354362 description : |
355363 Short-lived JWT obtained by exchanging Docker Hub credentials at
356- `POST https://hub.docker.com/v2/users/login `. Pass the JWT in the
364+ `POST https://hub.docker.com/v2/auth/token `. Pass the JWT in the
357365 `Authorization: Bearer <token>` header. Tokens expire after a short
358366 period; request a fresh one when you receive a `401`.
359367
360- The `password` field of the login request accepts any of the following
368+ The `password` field of the token request accepts any of the following
361369 credential types:
362370
363371 | Type | Format | Notes |
@@ -367,7 +375,7 @@ components:
367375 | Organization Access Token (OAT) | `dckr_oat_*` | Scoped to an organization. Create one under Organization Settings → Access Tokens. |
368376
369377 PAT and OAT strings can't be used directly as a bearer token. They must
370- be exchanged at the login endpoint first.
378+ be exchanged at the token endpoint first.
371379
372380 See [Docker Hub authentication](https://docs.docker.com/reference/api/hub/latest/#tag/authentication-api/operation/AuthCreateAccessToken)
373381 for full details.
@@ -659,13 +667,14 @@ components:
659667 type : string
660668 description : >
661669 Machine-readable error code. `not_found`: the requested resource
662- does not exist. `conflict`: a resource with the same name already
663- exists. `invalid_argument`: the request body is malformed or
664- fails validation. `unauthenticated`: missing or invalid
665- credentials. `permission_denied`: the caller lacks the required
666- permission, or the org is not entitled to use governance.
667- `unimplemented`: the endpoint or feature is not yet available.
668- `internal`: unexpected server error.
670+ does not exist, the org does not exist, or the caller is not a
671+ member of the org (the org's existence is not revealed to callers
672+ who cannot access it). `conflict`: a resource with the same name
673+ already exists. `invalid_argument`: the request body is malformed
674+ or fails validation. `unauthenticated`: missing or invalid
675+ credentials. `permission_denied`: the org is not entitled to use
676+ governance. `unimplemented`: the endpoint or feature is not yet
677+ available. `internal`: unexpected server error.
669678 enum :
670679 - not_found
671680 - conflict
0 commit comments