Skip to main content

Adds a new version release of a plugin

POST 
/api/plugins/:frankenStyle/versions

Submits a new version of a plugin you have permission to maintain, as multipart/form-data.

Give the archive exactly one way: upload it in file, or point at it over HTTPS in fileUrl. Sending both, or neither, is a 422.

The build number, release name, maturity and supported Moodle versions are read out of the archive's version.php — do not send them, they cannot be overridden. The remaining fields are optional and are the only things the archive cannot tell us.

On success you get 201 with the created version. Its status normally reads in_testing rather than uploaded: submitting a version queues it for automated pre-check straight away, so uploaded is never observable. Do not poll for it.

A rejected archive answers 422 with one entry per problem under violations. The same shape covers a bad URL, an unreachable one, and an archive over the size limit.

Request​

Responses​

The plugin version was submitted.