@Resource("{id}")
@Serializable
data class FileResource(val parent: FilesResource = FilesResource(), val id: FileId) {

    // Swagger data
    object Get : ResourceDescription by describeResource({

        operationId = "getFile"

        summary = "Gets an existing file's download URL"

        tags += "File"

        "id" pathParameter {
            description = "The id of the file to get"
            example = "file-id.pdf"
            required = true
        }

        200 response {
            json { schema(DownloadResponse("http://…/file-id.pdf")) }
        }

    })

    // Swagger data
    object Delete : ResourceDescription by describeResource({

        operationId = "deleteFile"

        summary = "Deletes an existing file"

        tags += "File"

        "id" pathParameter {
            description = "The id of the file to delete"
            example = "file-id.pdf"
            required = true
        }

        200 response {
            description = "File deleted"
        }

    })

    @Serializable
    data class DownloadResponse(val url: String)

}