Annotation Open API & Symfony : multipart/form-data requestBody

Category.php

/**
 * ...
 *
 * @OA\Schema(
 *     schema="CategoryPost",
 *     type="object",
 *     ...
 *     
 *     @OA\Property(
 *          type="object",
 *          property="parent",
 *          required={"id"},
 *          @OA\Property(type="integer", property="id", example=12),
 *     ),
 * )
 * 
 *...
 */
class Category
{
  ...
}

MyController.php

class MyController extends AbstractController
{
    /**
     * ...
     *
     * @OA\Post(
     *     tags={"Categories"},
     *     path="/api/categories",
     *     description="Create a category for company",
     *     security={
     *         {"Bearer": {}}
     *     },
     *     @OA\RequestBody(
     *          required=true,
     *          @OA\MediaType(
     *              mediaType="multipart/form-data",
     *              @OA\Schema(ref="#/components/schemas/CategoryPost"),
     *          ),
     *     ),
     *     
     *     ...
     * )
     *
     */
    public function __invoke()
    {
        ...
    }
}

You'll have this :

Postman

Swagger