Reviewers
Note
These APIs are not frozen and can change at any time without warning. See the API versions available for alternatives if you need stability.
The only authentication method available for these APIs is the internal one, except for the validation results endpoint, which allows both internal and external auth.
Subscribe
This endpoint allows you to subscribe the current user to the notification sent when a new version is submitted on a particular add-on.
Note
Requires authentication and the current user to have any reviewer-related permission.
Note
.../subscribe/
uses the listed channel implicitly. This endpoint is deprecated, use the explicit channel endpoints.
- POST /api/v5/reviewers/addon/(int: addon_id)/subscribe/
- POST /api/v5/reviewers/addon/(int: addon_id)/subscribe_listed/
- POST /api/v5/reviewers/addon/(int: addon_id)/subscribe_unlisted/
Unsubscribe
This endpoint allows you to unsubscribe the current user to the notification sent when a new version is submitted on a particular add-on.
Note
Requires authentication and the current user to have any reviewer-related permission.
Note
.../unsubscribe/
uses the listed channel implicitly. This endpoint is deprecated, use the explicit channel endpoints.
- POST /api/v5/reviewers/addon/(int: addon_id)/unsubscribe/
- POST /api/v5/reviewers/addon/(int: addon_id)/unsubscribe_listed/
- POST /api/v5/reviewers/addon/(int: addon_id)/unsubscribe_unlisted/
File Validation
This endpoint allows you to view the validation results of a given file belonging to an add-on.
Note
Requires authentication and the current user to have any reviewer-related permission.
- POST /api/v5/reviewers/addon/(int: addon_id)/file/(int: file_id)/validation/
- Response JSON Object:
validation (object) – the validation results
Flags
This endpoint allows you to manipulate various reviewer-specific flags on an add-on.
Note
Requires authentication and the current user to have
Reviews:Admin
permission.
- PATCH /api/v5/reviewers/addon/(int: addon_id)/flags/
- Response JSON Object:
auto_approval_disabled (boolean) – Boolean indicating whether auto approval of listed versions is disabled on an add-on or not. When it’s
true
, new listed versions for this add-on will make it appear in the regular reviewer queues instead of being auto-approved.auto_approval_disabled_until_next_approval (boolean) – Boolean indicating whether auto approval of listed versions is disabled on an add-on until the next listed version is approved or not. Has the same effect as
auto_approval_disabled
but is automatically reset tofalse
when the latest listed version of the add-on is manually approved by a human reviewer.auto_approval_delayed_until (string|null) – Date until the add-on auto-approval is delayed for listed versions.
auto_approval_disabled_unlisted (boolean) – Boolean indicating whether auto approval of unlisted versions is disabled on an add-on or not. When it’s
true
, new unlisted versions for this add-on will make it appear in the regular reviewer queues instead of being auto-approved.auto_approval_disabled_until_next_approval_unlisted (boolean) – Boolean indicating whether auto approval of unlisted versions is disabled on an add-on until the next unlisted version is approved or not. Has the same effect as
auto_approval_disabled_unlisted
but is automatically reset tofalse
when the latest unlisted version of the add-on is manually approved by a human reviewer.auto_approval_delayed_until_unlisted (string|null) – Date until the add-on auto-approval is delayed for unlisted versions.
needs_admin_theme_review (boolean) – Boolean indicating whether the theme needs to be reviewed by an admin or not.
Allow resubmission
This endpoint allows you to allow resubmission of an add-on that was previously denied.
Note
Requires authentication and the current user to have
Reviews:Admin
permission.
- POST /api/v5/reviewers/addon/(int: addon_id)/allow_resubmission/
- Status Codes:
202 Accepted – Success.
409 Conflict – The add-on GUID was not previously denied.
Deny resubmission
This endpoint allows you to deny resubmission of an add-on that was not already denied.
Note
Requires authentication and the current user to have
Reviews:Admin
permission.
- POST /api/v5/reviewers/addon/(int: addon_id)/deny_resubmission/
- Status Codes:
202 Accepted – Success.
409 Conflict – The add-on GUID was already denied.