Fix issue #24406: correct Docker Hub API documentation (#24443)

Fixes discrepancies in the Docker Hub organization access token API
documentation to match actual API behavior.

Changes:
- Removed `created_by` field from create endpoint response (API only
returns `created_at`)
- Updated scope examples from `repo-pull` to `scope-image-pull` (correct
format with `scope-` prefix)
- Enhanced repository path documentation with validation requirements
for TYPE_REPO resources

These changes align the OpenAPI specification with the actual API
implementation as discovered during Terraform provider development.

Fixes #24406

---------

Co-authored-by: David Karlsson <dvdksn@users.noreply.github.com>

Author: dvdksn

content/reference/api/hub/latest.yaml

@@ -1104,7 +1104,7 @@ paths:
       summary: "Update repository immutable tags"
       description: |
         Updates the immutable tags configuration for this repository.
-        
+
         **Only users with administrative privileges for the repository can modify these settings.**
       tags:
         - repositories
@@ -1132,7 +1132,7 @@ paths:
       summary: "Verify repository immutable tags"
       description: |
         Validates  the immutable tags regex pass in parameter and returns a list of tags matching it in this repository.
-        
+
         **Only users with administrative privileges for the repository call this endpoint.**
       tags:
         - repositories
@@ -1167,7 +1167,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RepositoryGroupCreationRequest'
+              $ref: "#/components/schemas/RepositoryGroupCreationRequest"
             example:
               group_id: 12345
               permission: "write"
@@ -1177,7 +1177,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RepositoryGroup'
+                $ref: "#/components/schemas/RepositoryGroup"
               example:
                 group_name: "developers"
                 permission: "write"
@@ -1202,13 +1202,13 @@ paths:
       summary: List repositories in a namespace
       description: |
         Returns a list of repositories within the specified namespace (organization or user).
-        
+
         Public repositories are accessible to everyone, while private repositories require appropriate authentication and permissions.
       tags:
         - repositories
       security:
-        - bearerAuth: [ ]
-        - { }  # Allow anonymous access for public repositories
+        - bearerAuth: []
+        - {} # Allow anonymous access for public repositories
       parameters:
         - in: query
           name: page
@@ -1327,7 +1327,10 @@ paths:
                   summary: Invalid ordering value
                   value:
                     fields:
-                      ordering: [ "Invalid ordering value. Must be one of: name, -name, last_updated, -last_updated, pull_count, -pull_count" ]
+                      ordering:
+                        [
+                          "Invalid ordering value. Must be one of: name, -name, last_updated, -last_updated, pull_count, -pull_count",
+                        ]
                     text: "Invalid ordering value"
         "401":
           $ref: "#/components/responses/unauthorized"
@@ -1348,13 +1351,13 @@ paths:
       tags:
         - repositories
       security:
-        - BearerAuth: [ ]
+        - BearerAuth: []
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/repo_creation_request'
+              $ref: "#/components/schemas/repo_creation_request"
             example:
               name: "my-app"
               namespace: "myorganization"
@@ -1368,7 +1371,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/repository_info'
+                $ref: "#/components/schemas/repository_info"
               example:
                 name: "my-app"
                 namespace: "myorganization"
@@ -1386,12 +1389,12 @@ paths:
                 hub_user: "myorganization"
                 has_starred: false
                 full_description: "This is a comprehensive description of my application repository that contains additional details about the project."
-                media_types: [ ]
-                content_types: [ ]
-                categories: [ ]
+                media_types: []
+                content_types: []
+                categories: []
                 immutable_tags_settings:
                   enabled: false
-                  rules: [ ]
+                  rules: []
                 storage_size: null
                 source: null
         400:
@@ -1413,19 +1416,19 @@ paths:
       summary: Get repository in a namespace
       description: |
         Returns a repository within the specified namespace (organization or user).
-        
+
         Public repositories are accessible to everyone, while private repositories require appropriate authentication and permissions.
       tags:
         - repositories
       security:
-        - bearerAuth: [ ]
-        - { }  # Allow anonymous access for public repositories
+        - bearerAuth: []
+        - {} # Allow anonymous access for public repositories
       responses:
         200:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/repository_info'
+                $ref: "#/components/schemas/repository_info"
               example:
                 name: "my-app"
                 namespace: "myorganization"
@@ -1443,12 +1446,12 @@ paths:
                 hub_user: "myorganization"
                 has_starred: false
                 full_description: "This is a comprehensive description of my application repository that contains additional details about the project."
-                media_types: [ ]
-                content_types: [ ]
-                categories: [ ]
+                media_types: []
+                content_types: []
+                categories: []
                 immutable_tags_settings:
                   enabled: false
-                  rules: [ ]
+                  rules: []
                 storage_size: null
                 source: null
         401:
@@ -1464,19 +1467,19 @@ paths:
       summary: Check repository in a namespace
       description: |
         Check a repository within the specified namespace (organization or user).
-        
+
         Public repositories are accessible to everyone, while private repositories require appropriate authentication and permissions.
       tags:
         - repositories
       security:
-        - bearerAuth: [ ]
-        - { }  # Allow anonymous access for public repositories
+        - bearerAuth: []
+        - {} # Allow anonymous access for public repositories
       responses:
         200:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/repository_info'
+                $ref: "#/components/schemas/repository_info"
               example:
                 name: "my-app"
                 namespace: "myorganization"
@@ -1494,12 +1497,12 @@ paths:
                 hub_user: "myorganization"
                 has_starred: false
                 full_description: "This is a comprehensive description of my application repository that contains additional details about the project."
-                media_types: [ ]
-                content_types: [ ]
-                categories: [ ]
+                media_types: []
+                content_types: []
+                categories: []
                 immutable_tags_settings:
                   enabled: false
-                  rules: [ ]
+                  rules: []
                 storage_size: null
                 source: null
         401:
@@ -2634,7 +2637,7 @@ components:
             Letters must be lowercase.
           minLength: 2
           maxLength: 255
-          pattern: '^[a-z0-9]+(?:[._-][a-z0-9]+)*$'
+          pattern: "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
           example: "my-app"
         namespace:
           type: string
@@ -2677,7 +2680,7 @@ components:
             - read: Can view and pull from the repository
             - write: Can view, pull, and push to the repository
             - admin: Can view, pull, push, and manage repository settings
-          enum: [ "read", "write", "admin" ]
+          enum: ["read", "write", "admin"]
           example: "write"
     RepositoryGroup:
       type: object
@@ -2689,7 +2692,7 @@ components:
         permission:
           type: string
           description: The permission level granted to the group
-          enum: [ "read", "write", "admin" ]
+          enum: ["read", "write", "admin"]
           example: "write"
         group_id:
           type: integer
@@ -2771,7 +2774,7 @@ components:
           nullable: true
           description: Full description of the repository
         permissions:
-          $ref: '#/components/schemas/repo_permissions'
+          $ref: "#/components/schemas/repo_permissions"
         media_types:
           type: array
           items:
@@ -2786,10 +2789,10 @@ components:
         categories:
           type: array
           items:
-            $ref: '#/components/schemas/category'
+            $ref: "#/components/schemas/category"
           description: Repository categories
         immutable_tags_settings:
-          $ref: '#/components/schemas/immutable_tags_settings'
+          $ref: "#/components/schemas/immutable_tags_settings"
         storage_size:
           type: integer
           format: int64
@@ -2856,7 +2859,7 @@ components:
           type: string
           pattern: '^[a-z0-9]+((\\.|_|__|-+)[a-z0-9]+)*(\\/[a-z0-9]+((\\.|_|__|-+)[a-z0-9]+)*)*$'
           description: 'Immutable tags rule regex pattern. Must match format: [a-z0-9]+((\\.|_|__|-+)[a-z0-9]+)*(\\/[a-z0-9]+((\\.|_|__|-+)[a-z0-9]+)*)*'
-          example: 'v.*'
+          example: "v.*"
       required:
         - regex
     immutable_tags_verify_response:
@@ -2868,9 +2871,9 @@ components:
             type: string
           description: List of tags that match the provided regex pattern
           example:
-            - 'v1.0.0'
-            - 'v2.1.3'
-            - 'latest'
+            - "v1.0.0"
+            - "v2.1.3"
+            - "latest"
       required:
         - tags
     repository_list_entry:
@@ -4014,14 +4017,17 @@ components:
           description: |
             The path of the resource. The format of this will change depending on the type of resource.
 
-            To reference public repositories, use `*/*/public` as the path value.
+            For TYPE_REPO resources:
+            - Must be an existing repository name (e.g., "myorg/myrepo")
+            - Can use glob patterns (e.g., "myorg/*" for all repositories in the organization)
+            - Use "*/*/public" to reference all public repositories
           required: true
         scopes:
           type: array
           description: The scopes this token has access to
           items:
             type: string
-            example: "repo-pull"
+            example: "scope-image-pull"
           required: true
     getOrgAccessTokensResponse:
       type: object
@@ -4075,7 +4081,31 @@ components:
     createOrgAccessTokenResponse:
       type: object
       allOf:
-        - $ref: "#/components/schemas/orgAccessToken"
+        - type: object
+          properties:
+            id:
+              type: string
+              example: "a7a5ef25-8889-43a0-8cc7-f2a94268e861"
+            label:
+              type: string
+              example: "My organization token"
+            is_active:
+              type: boolean
+              example: true
+            created_at:
+              type: string
+              format: date-time
+              example: "2022-05-20T00:54:18Z"
+            expires_at:
+              type: string
+              format: date-time
+              example: "2023-05-20T00:54:18Z"
+              nullable: true
+            last_used_at:
+              type: string
+              format: date-time
+              example: "2022-06-15T12:30:45Z"
+              nullable: true
         - type: object
           properties:
             token: