Example API controller documented with vimeo/mill

UserController.php

<?php
namespace Vimeo\Controllers\Api;

use Vimeo\Api\Response\UserResponse;

class UserController extends \Vimeo\Controller
{
    /**
     * @api-label Get a user
     * @api-operationId get_user
     * @api-group Users\Essentials
     *
     * @api-path:public:alias /me
     * @api-path:public /users/+user_id
     * @api-pathParam user_id `152184` (integer) - The ID of the user.
     *
     * @api-contentType application/vnd.vimeo.user+json
     *
     * @api-return:public {object} \Vimeo\Api\Response\UserResponse The user was returned.
     */
    public function GET(\Vimeo\Api\Request $request): UserResponse
    {
        return new UserResponse($request->getUser());
    }
}

UserResponse.php

<?php
namespace Vimeo\Api\Response;

/**
 * @api-label User
 */
class UserResponse extends Response
{
    const CONTENT_TYPE = 'application/vnd.vimeo.user';

    protected function _json($user)
    {
        return [
            /**
             * @api-data uri `/users/152184` (uri) - The user's canonical relative URI.
             */
            'uri' => '/users/' . $user->id
        ];
    }
}