> For the complete documentation index, see [llms.txt](https://developers.make.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.make.com/white-label-documentation/admin-api-reference/admin-sdk-apps-review.md).

# Admin / SDK Apps / Review

## Sync review form categories

> Replaces the category taxonomy of the new SDK app review form with the posted list. The catalog's source of truth is external (maintained outside Make and pushed here by a sync script), so this endpoint takes the \*\*whole\*\* list and merges it — it is not a per-category create/update:\
> \* an entry whose \`slug\` is new is created; \* an entry whose \`slug\` already exists has its \`name\` and display order updated; \* an entry whose \`slug\` was retired by an earlier sync is brought back; \* a category or subcategory the list no longer contains is retired — it stops being\
> &#x20; offered by the form, but is \*\*not\*\* deleted, so a slug already stored in a review\
> &#x20; form keeps resolving to its label. A later sync that lists it again revives the same\
> &#x20; row.\
> \
> Display order is the order of the array (and, for subcategories, of each \`subcategories\` array). \`slug\` is optional: when omitted it is derived from the label (diacritics stripped, lowercased, runs of non-alphanumerics collapsed to a dash, so \`"Microsoft (Enterprise)"\` → \`microsoft-enterprise\`). Pin an explicit \`slug\` whenever the label may be reworded later — the slug is the identity stored in review forms, so letting it follow a rename retires the old value and creates a new one instead of relabelling in place. A label with no ASCII alphanumerics at all (e.g. CJK-only) cannot be derived from and is rejected with \`400\` (IM005); pass a \`slug\` for it.\
> The operation is idempotent: re-posting an unchanged list reports no changes and sends nothing anywhere, which makes it safe to run on a schedule. An empty array is rejected rather than treated as "retire everything" — that payload is almost always a syncing script whose upstream fetch came back empty.\
> The catalog is platform-global and HQ-mastered. On a multi-zone (HQ-managed) installation the zone that accepts this request computes the \*\*diff\*\* between the posted list and its catalog and hands the diff to HQ; nothing is applied locally by the request itself. HQ applies the diff to the master copy and broadcasts it to every zone — including this one, which is how the local catalog converges, typically within a second. A read issued immediately after this call may therefore still serve the previous catalog. When HQ cannot be reached the request fails with \`503\` and nothing was changed anywhere — simply retry. On a single-instance (master mode) installation there is no HQ and the diff is applied locally within the request.\
> Available only while the \`is\_sdk\_app\_review\_enabled\` feature flag is on, otherwise responds with \`400\` (IM903).

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["admin:write","sdk-apps:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/admin/sdk/app-review/categories":{"put":{"tags":["Admin / SDK Apps / Review"],"summary":"Sync review form categories","description":"Replaces the category taxonomy of the new SDK app review form with the posted list. The catalog's source of truth is external (maintained outside Make and pushed here by a sync script), so this endpoint takes the **whole** list and merges it — it is not a per-category create/update:\n* an entry whose `slug` is new is created; * an entry whose `slug` already exists has its `name` and display order updated; * an entry whose `slug` was retired by an earlier sync is brought back; * a category or subcategory the list no longer contains is retired — it stops being\n  offered by the form, but is **not** deleted, so a slug already stored in a review\n  form keeps resolving to its label. A later sync that lists it again revives the same\n  row.\n\nDisplay order is the order of the array (and, for subcategories, of each `subcategories` array). `slug` is optional: when omitted it is derived from the label (diacritics stripped, lowercased, runs of non-alphanumerics collapsed to a dash, so `\"Microsoft (Enterprise)\"` → `microsoft-enterprise`). Pin an explicit `slug` whenever the label may be reworded later — the slug is the identity stored in review forms, so letting it follow a rename retires the old value and creates a new one instead of relabelling in place. A label with no ASCII alphanumerics at all (e.g. CJK-only) cannot be derived from and is rejected with `400` (IM005); pass a `slug` for it.\nThe operation is idempotent: re-posting an unchanged list reports no changes and sends nothing anywhere, which makes it safe to run on a schedule. An empty array is rejected rather than treated as \"retire everything\" — that payload is almost always a syncing script whose upstream fetch came back empty.\nThe catalog is platform-global and HQ-mastered. On a multi-zone (HQ-managed) installation the zone that accepts this request computes the **diff** between the posted list and its catalog and hands the diff to HQ; nothing is applied locally by the request itself. HQ applies the diff to the master copy and broadcasts it to every zone — including this one, which is how the local catalog converges, typically within a second. A read issued immediately after this call may therefore still serve the previous catalog. When HQ cannot be reached the request fails with `503` and nothing was changed anywhere — simply retry. On a single-instance (master mode) installation there is no HQ and the diff is applied locally within the request.\nAvailable only while the `is_sdk_app_review_enabled` feature flag is on, otherwise responds with `400` (IM903).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","minItems":1,"maxItems":200,"description":"The complete category list, in display order.","items":{"type":"object","additionalProperties":false,"required":["category"],"properties":{"category":{"type":"string","minLength":1,"maxLength":255,"description":"Human-readable label of the category."},"slug":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Stable identifier of the category. Optional — derived from `category` when omitted. Must already be in canonical form."},"subcategories":{"type":"array","maxItems":500,"description":"The category's subcategories in display order. Omit or pass an empty array for a category with none.","items":{"description":"Either the subcategory's label, or an object pinning an explicit slug to it.","oneOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":255,"description":"Human-readable label of the subcategory."},"slug":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Stable identifier within the owning category. Optional — derived from `name` when omitted."}}}]}}}}}}}},"responses":{"200":{"description":"The catalog as posted (normalized — slugs resolved, labels trimmed), which is the state every zone converges to once the diff lands, plus what the sync changed. `changes` lists slugs (subcategories as `<categorySlug>/<subcategorySlug>`) so the syncing script can log them; all four buckets are empty when the posted list matched what was already stored.","content":{"application/json":{"schema":{"type":"object","properties":{"categories":{"type":"array","items":{"type":"object","description":"One category of the taxonomy offered by the new SDK app review form, with its subcategories. `slug` is the category's stable identity — it is what a review form stores in `categories` / `subcategories`, and it survives a rename of `name`. Array order is display order.","properties":{"slug":{"type":"string","maxLength":128,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Stable identifier of the category. Either pinned explicitly by the catalog sync or derived from `name` (diacritics stripped, lowercased, every run of non-alphanumerics collapsed to a dash)."},"name":{"type":"string","maxLength":255,"description":"Human-readable label to show in the review form."},"subcategories":{"type":"array","description":"The category's subcategories in display order; empty when the category has none. The taxonomy is exactly two levels deep — a subcategory never has children of its own.","items":{"type":"object","properties":{"slug":{"type":"string","maxLength":128,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Stable identifier of the subcategory, unique within its category (the same slug may appear under a different category)."},"name":{"type":"string","maxLength":255,"description":"Human-readable label to show in the review form."}}}}}}},"changes":{"type":"object","description":"What one catalog sync changed, per taxonomy level.","properties":{"categories":{"type":"object","description":"What one catalog sync did to one taxonomy level. Values are slugs, so a syncing script can log them verbatim; subcategories are keyed `<categorySlug>/<subcategorySlug>`, since a subcategory slug is only unique within its category. All four buckets are empty when the posted list matched what was already stored.","properties":{"created":{"type":"array","description":"Slugs that did not exist before this sync.","items":{"type":"string"}},"updated":{"type":"array","description":"Slugs whose label or display order changed.","items":{"type":"string"}},"restored":{"type":"array","description":"Slugs an earlier sync had retired and this one brought back.","items":{"type":"string"}},"removed":{"type":"array","description":"Slugs that were being offered and this sync retired.","items":{"type":"string"}}}},"subcategories":{"type":"object","description":"What one catalog sync did to one taxonomy level. Values are slugs, so a syncing script can log them verbatim; subcategories are keyed `<categorySlug>/<subcategorySlug>`, since a subcategory slug is only unique within its category. All four buckets are empty when the posted list matched what was already stored.","properties":{"created":{"type":"array","description":"Slugs that did not exist before this sync.","items":{"type":"string"}},"updated":{"type":"array","description":"Slugs whose label or display order changed.","items":{"type":"string"}},"restored":{"type":"array","description":"Slugs an earlier sync had retired and this one brought back.","items":{"type":"string"}},"removed":{"type":"array","description":"Slugs that were being offered and this sync retired.","items":{"type":"string"}}}}}}}}}}},"400":{"description":"The list is not a valid catalog — a slug is repeated, a label is blank, a label cannot be turned into a slug, or the array is empty or malformed.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Application error code."},"message":{"type":"string","description":"Error message."},"detail":{"type":"array","description":"Validation error details.","items":{"type":"string"}}}}}}},"403":{"description":"The caller does not hold the `apps edit` admin permission.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"503":{"description":"HQ could not be reached (multi-zone installations only). Nothing was changed anywhere — the sync is safe to retry once HQ is back.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}}
```

## Get app review state (reviewer)

> The reviewer's read of the new review flow for an app version — the same state the author sees through \`GET /sdk/apps/{SDK\_appName}/{SDK\_appVersion}/app-review\`: the lifecycle phase, the auto-saved draft, the submitted snapshot (\`submittedForm\` is what the reviewer should judge) and the history timeline. Requires an administrator with the \`apps get\` permission. Available only while the \`is\_sdk\_app\_review\_enabled\` feature flag is on, otherwise responds with \`400\` (IM903).

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["admin:read","sdk-apps:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/admin/sdk/apps/{app}/{version}/app-review":{"get":{"tags":["Admin / SDK Apps / Review"],"summary":"Get app review state (reviewer)","description":"The reviewer's read of the new review flow for an app version — the same state the author sees through `GET /sdk/apps/{SDK_appName}/{SDK_appVersion}/app-review`: the lifecycle phase, the auto-saved draft, the submitted snapshot (`submittedForm` is what the reviewer should judge) and the history timeline. Requires an administrator with the `apps get` permission. Available only while the `is_sdk_app_review_enabled` feature flag is on, otherwise responds with `400` (IM903).","parameters":[{"name":"app","in":"path","schema":{"type":"string"},"required":true,"description":"Name of the SDK app."},{"name":"version","in":"path","schema":{"type":"integer"},"required":true,"description":"Major version of the SDK app."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"review":{"type":"object","description":"State of the new SDK app review flow for one app version. The lifecycle phase either comes from the new flow's own storage or, while the new flow has never touched the app (`derivedFromLegacy: true`), is derived from the legacy review state (`approved`/`in_review` flags and the legacy review status). Every lifecycle step is traced to Trackman with the legacy event closest to it: the submission that requests the review as `apps_review_requested`, every other step (including the reviewer's) as `apps_review_form_updated`, whose `review_form.event` is the timeline event the step appended. Auto-saving the draft (`PUT …/app-review/form`) is not a step and is not traced.","properties":{"appName":{"type":"string","description":"Name of the SDK app."},"appVersion":{"type":"integer","description":"Major version of the SDK app."},"phase":{"type":"string","enum":["dormant","preparing","review","changes_required","approved","updating","update_review","changes_required_update","rereview"],"description":"Lifecycle phase of the review. `dormant` → `start` → `preparing` → `submit` → `review`; a reviewer then approves (`approved`) or requests changes (`changes_required`, reopened with `start-rereview` → `rereview` → `submit` back to `review`). An approved listing is updated through `start-update` → `updating` → `submit` → `update_review`, whose outcomes are `approved` or `changes_required_update` (re-reviewed through `rereview` back to `update_review`). `cancel` steps back one phase on every track."},"reviewStep":{"type":"string","enum":["auto","manual"],"nullable":true,"description":"Sub-step while `phase` is `review`/`update_review` — `manual` means the submission waits with Make (where every submission starts), `auto` means Make sent the automatic-review notes and waits on the developer to implement and confirm them. `null` in every other phase."},"rereviewOrigin":{"type":"string","enum":["changes_required","changes_required_update"],"nullable":true,"description":"While `phase` is `rereview`, the phase the re-review was started from. `null` otherwise."},"derivedFromLegacy":{"type":"boolean","description":"`true` when `phase` was derived from legacy review state instead of stored new-flow state."},"draftForm":{"type":"object","additionalProperties":false,"description":"The new review form. Every field is optional — any partial state is a valid auto-save; completeness is enforced by the client before submitting, not by the server. Link formats are checked when submitting: documentation links must be `http(s)` URLs and scenario links must point at a scenario of this zone (`https://<zone web domain>/<teamId>/scenarios/<scenarioId>/edit`).","properties":{"vendorRelationship":{"type":"string","enum":["direct","agreement","none"],"description":"The developer's relationship to the vendor of the integrated software."},"listingType":{"type":"string","enum":["verified","community"],"description":"Requested Marketplace listing type. The choice is only offered to Solution Partners without a vendor agreement."},"partnerProgramApplication":{"type":"string","enum":["technology","solution"],"description":"Make partner program the developer applies for together with this review, agreeing to the Make terms and conditions; omitted when not applying. Offered only to developers who are not Make partners yet, for the program their vendor relationship makes them eligible for: `none` → `solution`, otherwise `technology`."},"testScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Scenarios where the review team can see every module of the app run successfully. Each must be a scenario link of this zone when submitting."},"errorHandlingScenarioUrl":{"type":"string","maxLength":2048,"description":"Scenario that fails on purpose, demonstrating how the app surfaces an API error. Must be a scenario link of this zone when submitting."},"apiDocsUrl":{"type":"string","maxLength":2048,"description":"Documentation of the API the app calls. Must be an `http(s)` URL when submitting."},"homepageUrl":{"type":"string","maxLength":2048,"description":"Homepage of the integrated software, shown on the app's landing page. Must be an `http(s)` URL when submitting."},"categories":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":128},"description":"Marketplace categories the app belongs to."},"subcategories":{"type":"object","additionalProperties":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":128}},"description":"Selected subcategories, keyed by category."},"shortDescription":{"type":"string","maxLength":1024,"description":"Community listing only — short description of the app."},"pricing":{"type":"string","enum":["free","paid"],"description":"Community listing only — whether the app itself is free or paid."},"landingPageUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's own landing page. Must be an `http(s)` URL when submitting."},"appDocsUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's documentation. Must be an `http(s)` URL when submitting."},"dataProcessingDescription":{"type":"string","maxLength":10000,"description":"Community listing only — how the app processes data. The developer is liable for this text."},"termsConsent":{"type":"boolean","description":"Community listing only — consent to the Make Apps Marketplace terms and conditions."},"supportContactName":{"type":"string","maxLength":255,"description":"Name Make forwards support and maintenance requests to."},"supportContactEmail":{"type":"string","maxLength":255,"description":"Email Make forwards support and maintenance requests to."},"trademarkConsent":{"type":"boolean","description":"Trademark compliance declaration."},"externalTcConsent":{"type":"boolean","description":"External service terms compliance declaration."},"whatChanged":{"type":"string","maxLength":10000,"description":"Update/re-review only — what changed in this version, or what was changed in response to the reviewer."},"updatedScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Update/re-review only — the test scenarios for the change, seeded from the approved submission. Each must be a scenario link of this zone when submitting."},"reRunConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that every scenario was re-run on the current app version."},"contactsConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that the developer and support contacts are up to date."}}},"submittedForm":{"nullable":true,"allOf":[{"type":"object","additionalProperties":false,"description":"The new review form. Every field is optional — any partial state is a valid auto-save; completeness is enforced by the client before submitting, not by the server. Link formats are checked when submitting: documentation links must be `http(s)` URLs and scenario links must point at a scenario of this zone (`https://<zone web domain>/<teamId>/scenarios/<scenarioId>/edit`).","properties":{"vendorRelationship":{"type":"string","enum":["direct","agreement","none"],"description":"The developer's relationship to the vendor of the integrated software."},"listingType":{"type":"string","enum":["verified","community"],"description":"Requested Marketplace listing type. The choice is only offered to Solution Partners without a vendor agreement."},"partnerProgramApplication":{"type":"string","enum":["technology","solution"],"description":"Make partner program the developer applies for together with this review, agreeing to the Make terms and conditions; omitted when not applying. Offered only to developers who are not Make partners yet, for the program their vendor relationship makes them eligible for: `none` → `solution`, otherwise `technology`."},"testScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Scenarios where the review team can see every module of the app run successfully. Each must be a scenario link of this zone when submitting."},"errorHandlingScenarioUrl":{"type":"string","maxLength":2048,"description":"Scenario that fails on purpose, demonstrating how the app surfaces an API error. Must be a scenario link of this zone when submitting."},"apiDocsUrl":{"type":"string","maxLength":2048,"description":"Documentation of the API the app calls. Must be an `http(s)` URL when submitting."},"homepageUrl":{"type":"string","maxLength":2048,"description":"Homepage of the integrated software, shown on the app's landing page. Must be an `http(s)` URL when submitting."},"categories":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":128},"description":"Marketplace categories the app belongs to."},"subcategories":{"type":"object","additionalProperties":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":128}},"description":"Selected subcategories, keyed by category."},"shortDescription":{"type":"string","maxLength":1024,"description":"Community listing only — short description of the app."},"pricing":{"type":"string","enum":["free","paid"],"description":"Community listing only — whether the app itself is free or paid."},"landingPageUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's own landing page. Must be an `http(s)` URL when submitting."},"appDocsUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's documentation. Must be an `http(s)` URL when submitting."},"dataProcessingDescription":{"type":"string","maxLength":10000,"description":"Community listing only — how the app processes data. The developer is liable for this text."},"termsConsent":{"type":"boolean","description":"Community listing only — consent to the Make Apps Marketplace terms and conditions."},"supportContactName":{"type":"string","maxLength":255,"description":"Name Make forwards support and maintenance requests to."},"supportContactEmail":{"type":"string","maxLength":255,"description":"Email Make forwards support and maintenance requests to."},"trademarkConsent":{"type":"boolean","description":"Trademark compliance declaration."},"externalTcConsent":{"type":"boolean","description":"External service terms compliance declaration."},"whatChanged":{"type":"string","maxLength":10000,"description":"Update/re-review only — what changed in this version, or what was changed in response to the reviewer."},"updatedScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Update/re-review only — the test scenarios for the change, seeded from the approved submission. Each must be a scenario link of this zone when submitting."},"reRunConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that every scenario was re-run on the current app version."},"contactsConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that the developer and support contacts are up to date."}}}],"description":"Snapshot of `draftForm` taken at the last submit. Later draft edits do not change it."},"submittedAt":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of the last submit."},"events":{"type":"array","description":"Review history timeline, oldest first.","items":{"type":"object","properties":{"type":{"type":"string","description":"Event type. Developer-side (`actor: developer`): `preparation_started`, `submitted`, `cancelled`, `submission_withdrawn`, `auto_notes_confirmed`, `rereview_started`, `rereview_cancelled`, `resubmitted`, `update_started`, `update_submitted`, `update_withdrawn`, `update_cancelled`. Make-side (`actor: make`, with an optional `note`): `auto_notes_sent`, `approved`, `changes_requested`, `update_approved`, `update_changes_requested`."},"actor":{"type":"string","enum":["developer","make"],"description":"Which side of the review produced the event."},"note":{"type":"string","description":"Optional free-text detail (e.g. the reviewer's request). Omitted when empty."},"createdAt":{"type":"string","format":"date-time","description":"When the event happened."}}}},"updatedAt":{"type":"string","format":"date-time","nullable":true,"description":"Last modification of the new-flow state. `null` while no new-flow row exists."}}}}}}}},"403":{"description":"The caller is not an administrator with the `apps get` permission.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"The app version does not exist.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Approve a submission (reviewer)

> Records Make's approval of the submission currently in review: \`review\` (a first review or a re-review of one) and \`update\_review\` (an update, or its re-review) both move to \`approved\`. The event appended is \`approved\` for a first review and \`update\_approved\` for an update, with the optional \`note\` attached. Accepted in both review steps (\`auto\` and \`manual\`). Fails with \`409\` in any other phase.\
> This records the \*\*review outcome only\*\* — it does not publish the app. Listing the app on the Marketplace (compiling it and setting the \`approved\` flag) is still done through the legacy \`POST /admin/sdk/apps/{app}/{version}/approve\` endpoint.\
> Requires an administrator with the \`apps approve\` permission (the same one the legacy approval needs). Available only while the \`is\_sdk\_app\_review\_enabled\` feature flag is on, otherwise responds with \`400\` (IM903).

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["admin:write","sdk-apps:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/admin/sdk/apps/{app}/{version}/app-review/approve":{"post":{"tags":["Admin / SDK Apps / Review"],"summary":"Approve a submission (reviewer)","description":"Records Make's approval of the submission currently in review: `review` (a first review or a re-review of one) and `update_review` (an update, or its re-review) both move to `approved`. The event appended is `approved` for a first review and `update_approved` for an update, with the optional `note` attached. Accepted in both review steps (`auto` and `manual`). Fails with `409` in any other phase.\nThis records the **review outcome only** — it does not publish the app. Listing the app on the Marketplace (compiling it and setting the `approved` flag) is still done through the legacy `POST /admin/sdk/apps/{app}/{version}/approve` endpoint.\nRequires an administrator with the `apps approve` permission (the same one the legacy approval needs). Available only while the `is_sdk_app_review_enabled` feature flag is on, otherwise responds with `400` (IM903).","parameters":[{"name":"app","in":"path","schema":{"type":"string"},"required":true,"description":"Name of the SDK app."},{"name":"version","in":"path","schema":{"type":"integer"},"required":true,"description":"Major version of the SDK app."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"note":{"type":"string","minLength":1,"maxLength":10000,"description":"Optional reviewer's note, stored on the timeline event the developer sees."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"review":{"type":"object","description":"State of the new SDK app review flow for one app version. The lifecycle phase either comes from the new flow's own storage or, while the new flow has never touched the app (`derivedFromLegacy: true`), is derived from the legacy review state (`approved`/`in_review` flags and the legacy review status). Every lifecycle step is traced to Trackman with the legacy event closest to it: the submission that requests the review as `apps_review_requested`, every other step (including the reviewer's) as `apps_review_form_updated`, whose `review_form.event` is the timeline event the step appended. Auto-saving the draft (`PUT …/app-review/form`) is not a step and is not traced.","properties":{"appName":{"type":"string","description":"Name of the SDK app."},"appVersion":{"type":"integer","description":"Major version of the SDK app."},"phase":{"type":"string","enum":["dormant","preparing","review","changes_required","approved","updating","update_review","changes_required_update","rereview"],"description":"Lifecycle phase of the review. `dormant` → `start` → `preparing` → `submit` → `review`; a reviewer then approves (`approved`) or requests changes (`changes_required`, reopened with `start-rereview` → `rereview` → `submit` back to `review`). An approved listing is updated through `start-update` → `updating` → `submit` → `update_review`, whose outcomes are `approved` or `changes_required_update` (re-reviewed through `rereview` back to `update_review`). `cancel` steps back one phase on every track."},"reviewStep":{"type":"string","enum":["auto","manual"],"nullable":true,"description":"Sub-step while `phase` is `review`/`update_review` — `manual` means the submission waits with Make (where every submission starts), `auto` means Make sent the automatic-review notes and waits on the developer to implement and confirm them. `null` in every other phase."},"rereviewOrigin":{"type":"string","enum":["changes_required","changes_required_update"],"nullable":true,"description":"While `phase` is `rereview`, the phase the re-review was started from. `null` otherwise."},"derivedFromLegacy":{"type":"boolean","description":"`true` when `phase` was derived from legacy review state instead of stored new-flow state."},"draftForm":{"type":"object","additionalProperties":false,"description":"The new review form. Every field is optional — any partial state is a valid auto-save; completeness is enforced by the client before submitting, not by the server. Link formats are checked when submitting: documentation links must be `http(s)` URLs and scenario links must point at a scenario of this zone (`https://<zone web domain>/<teamId>/scenarios/<scenarioId>/edit`).","properties":{"vendorRelationship":{"type":"string","enum":["direct","agreement","none"],"description":"The developer's relationship to the vendor of the integrated software."},"listingType":{"type":"string","enum":["verified","community"],"description":"Requested Marketplace listing type. The choice is only offered to Solution Partners without a vendor agreement."},"partnerProgramApplication":{"type":"string","enum":["technology","solution"],"description":"Make partner program the developer applies for together with this review, agreeing to the Make terms and conditions; omitted when not applying. Offered only to developers who are not Make partners yet, for the program their vendor relationship makes them eligible for: `none` → `solution`, otherwise `technology`."},"testScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Scenarios where the review team can see every module of the app run successfully. Each must be a scenario link of this zone when submitting."},"errorHandlingScenarioUrl":{"type":"string","maxLength":2048,"description":"Scenario that fails on purpose, demonstrating how the app surfaces an API error. Must be a scenario link of this zone when submitting."},"apiDocsUrl":{"type":"string","maxLength":2048,"description":"Documentation of the API the app calls. Must be an `http(s)` URL when submitting."},"homepageUrl":{"type":"string","maxLength":2048,"description":"Homepage of the integrated software, shown on the app's landing page. Must be an `http(s)` URL when submitting."},"categories":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":128},"description":"Marketplace categories the app belongs to."},"subcategories":{"type":"object","additionalProperties":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":128}},"description":"Selected subcategories, keyed by category."},"shortDescription":{"type":"string","maxLength":1024,"description":"Community listing only — short description of the app."},"pricing":{"type":"string","enum":["free","paid"],"description":"Community listing only — whether the app itself is free or paid."},"landingPageUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's own landing page. Must be an `http(s)` URL when submitting."},"appDocsUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's documentation. Must be an `http(s)` URL when submitting."},"dataProcessingDescription":{"type":"string","maxLength":10000,"description":"Community listing only — how the app processes data. The developer is liable for this text."},"termsConsent":{"type":"boolean","description":"Community listing only — consent to the Make Apps Marketplace terms and conditions."},"supportContactName":{"type":"string","maxLength":255,"description":"Name Make forwards support and maintenance requests to."},"supportContactEmail":{"type":"string","maxLength":255,"description":"Email Make forwards support and maintenance requests to."},"trademarkConsent":{"type":"boolean","description":"Trademark compliance declaration."},"externalTcConsent":{"type":"boolean","description":"External service terms compliance declaration."},"whatChanged":{"type":"string","maxLength":10000,"description":"Update/re-review only — what changed in this version, or what was changed in response to the reviewer."},"updatedScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Update/re-review only — the test scenarios for the change, seeded from the approved submission. Each must be a scenario link of this zone when submitting."},"reRunConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that every scenario was re-run on the current app version."},"contactsConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that the developer and support contacts are up to date."}}},"submittedForm":{"nullable":true,"allOf":[{"type":"object","additionalProperties":false,"description":"The new review form. Every field is optional — any partial state is a valid auto-save; completeness is enforced by the client before submitting, not by the server. Link formats are checked when submitting: documentation links must be `http(s)` URLs and scenario links must point at a scenario of this zone (`https://<zone web domain>/<teamId>/scenarios/<scenarioId>/edit`).","properties":{"vendorRelationship":{"type":"string","enum":["direct","agreement","none"],"description":"The developer's relationship to the vendor of the integrated software."},"listingType":{"type":"string","enum":["verified","community"],"description":"Requested Marketplace listing type. The choice is only offered to Solution Partners without a vendor agreement."},"partnerProgramApplication":{"type":"string","enum":["technology","solution"],"description":"Make partner program the developer applies for together with this review, agreeing to the Make terms and conditions; omitted when not applying. Offered only to developers who are not Make partners yet, for the program their vendor relationship makes them eligible for: `none` → `solution`, otherwise `technology`."},"testScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Scenarios where the review team can see every module of the app run successfully. Each must be a scenario link of this zone when submitting."},"errorHandlingScenarioUrl":{"type":"string","maxLength":2048,"description":"Scenario that fails on purpose, demonstrating how the app surfaces an API error. Must be a scenario link of this zone when submitting."},"apiDocsUrl":{"type":"string","maxLength":2048,"description":"Documentation of the API the app calls. Must be an `http(s)` URL when submitting."},"homepageUrl":{"type":"string","maxLength":2048,"description":"Homepage of the integrated software, shown on the app's landing page. Must be an `http(s)` URL when submitting."},"categories":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":128},"description":"Marketplace categories the app belongs to."},"subcategories":{"type":"object","additionalProperties":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":128}},"description":"Selected subcategories, keyed by category."},"shortDescription":{"type":"string","maxLength":1024,"description":"Community listing only — short description of the app."},"pricing":{"type":"string","enum":["free","paid"],"description":"Community listing only — whether the app itself is free or paid."},"landingPageUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's own landing page. Must be an `http(s)` URL when submitting."},"appDocsUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's documentation. Must be an `http(s)` URL when submitting."},"dataProcessingDescription":{"type":"string","maxLength":10000,"description":"Community listing only — how the app processes data. The developer is liable for this text."},"termsConsent":{"type":"boolean","description":"Community listing only — consent to the Make Apps Marketplace terms and conditions."},"supportContactName":{"type":"string","maxLength":255,"description":"Name Make forwards support and maintenance requests to."},"supportContactEmail":{"type":"string","maxLength":255,"description":"Email Make forwards support and maintenance requests to."},"trademarkConsent":{"type":"boolean","description":"Trademark compliance declaration."},"externalTcConsent":{"type":"boolean","description":"External service terms compliance declaration."},"whatChanged":{"type":"string","maxLength":10000,"description":"Update/re-review only — what changed in this version, or what was changed in response to the reviewer."},"updatedScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Update/re-review only — the test scenarios for the change, seeded from the approved submission. Each must be a scenario link of this zone when submitting."},"reRunConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that every scenario was re-run on the current app version."},"contactsConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that the developer and support contacts are up to date."}}}],"description":"Snapshot of `draftForm` taken at the last submit. Later draft edits do not change it."},"submittedAt":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of the last submit."},"events":{"type":"array","description":"Review history timeline, oldest first.","items":{"type":"object","properties":{"type":{"type":"string","description":"Event type. Developer-side (`actor: developer`): `preparation_started`, `submitted`, `cancelled`, `submission_withdrawn`, `auto_notes_confirmed`, `rereview_started`, `rereview_cancelled`, `resubmitted`, `update_started`, `update_submitted`, `update_withdrawn`, `update_cancelled`. Make-side (`actor: make`, with an optional `note`): `auto_notes_sent`, `approved`, `changes_requested`, `update_approved`, `update_changes_requested`."},"actor":{"type":"string","enum":["developer","make"],"description":"Which side of the review produced the event."},"note":{"type":"string","description":"Optional free-text detail (e.g. the reviewer's request). Omitted when empty."},"createdAt":{"type":"string","format":"date-time","description":"When the event happened."}}}},"updatedAt":{"type":"string","format":"date-time","nullable":true,"description":"Last modification of the new-flow state. `null` while no new-flow row exists."}}}}}}}},"403":{"description":"The caller is not an administrator with the `apps approve` permission.","content":{"application/json":{"schema":{"type":"object"}}}},"409":{"description":"Nothing is in review.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Request changes to a submission (reviewer)

> Returns the submission currently in review to the developer with a mandatory \`note\`: \`review\` moves to \`changes\_required\` (event \`changes\_requested\`), \`update\_review\` moves to \`changes\_required\_update\` (event \`update\_changes\_requested\`). The developer then starts a re-review (\`POST .../app-review/start-rereview\`), which reopens the form and resubmits onto the same track. Accepted in both review steps (\`auto\` and \`manual\`). Fails with \`409\` in any other phase and with \`400\` when the note is missing or empty.\
> Requires an administrator with the \`apps edit\` permission (the same one the legacy reviewer status form needs). Available only while the \`is\_sdk\_app\_review\_enabled\` feature flag is on, otherwise responds with \`400\` (IM903).

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["admin:write","sdk-apps:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/admin/sdk/apps/{app}/{version}/app-review/request-changes":{"post":{"tags":["Admin / SDK Apps / Review"],"summary":"Request changes to a submission (reviewer)","description":"Returns the submission currently in review to the developer with a mandatory `note`: `review` moves to `changes_required` (event `changes_requested`), `update_review` moves to `changes_required_update` (event `update_changes_requested`). The developer then starts a re-review (`POST .../app-review/start-rereview`), which reopens the form and resubmits onto the same track. Accepted in both review steps (`auto` and `manual`). Fails with `409` in any other phase and with `400` when the note is missing or empty.\nRequires an administrator with the `apps edit` permission (the same one the legacy reviewer status form needs). Available only while the `is_sdk_app_review_enabled` feature flag is on, otherwise responds with `400` (IM903).","parameters":[{"name":"app","in":"path","schema":{"type":"string"},"required":true,"description":"Name of the SDK app."},{"name":"version","in":"path","schema":{"type":"integer"},"required":true,"description":"Major version of the SDK app."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["note"],"properties":{"note":{"type":"string","minLength":1,"maxLength":10000,"description":"What the developer has to change, stored on the timeline event they see."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"review":{"type":"object","description":"State of the new SDK app review flow for one app version. The lifecycle phase either comes from the new flow's own storage or, while the new flow has never touched the app (`derivedFromLegacy: true`), is derived from the legacy review state (`approved`/`in_review` flags and the legacy review status). Every lifecycle step is traced to Trackman with the legacy event closest to it: the submission that requests the review as `apps_review_requested`, every other step (including the reviewer's) as `apps_review_form_updated`, whose `review_form.event` is the timeline event the step appended. Auto-saving the draft (`PUT …/app-review/form`) is not a step and is not traced.","properties":{"appName":{"type":"string","description":"Name of the SDK app."},"appVersion":{"type":"integer","description":"Major version of the SDK app."},"phase":{"type":"string","enum":["dormant","preparing","review","changes_required","approved","updating","update_review","changes_required_update","rereview"],"description":"Lifecycle phase of the review. `dormant` → `start` → `preparing` → `submit` → `review`; a reviewer then approves (`approved`) or requests changes (`changes_required`, reopened with `start-rereview` → `rereview` → `submit` back to `review`). An approved listing is updated through `start-update` → `updating` → `submit` → `update_review`, whose outcomes are `approved` or `changes_required_update` (re-reviewed through `rereview` back to `update_review`). `cancel` steps back one phase on every track."},"reviewStep":{"type":"string","enum":["auto","manual"],"nullable":true,"description":"Sub-step while `phase` is `review`/`update_review` — `manual` means the submission waits with Make (where every submission starts), `auto` means Make sent the automatic-review notes and waits on the developer to implement and confirm them. `null` in every other phase."},"rereviewOrigin":{"type":"string","enum":["changes_required","changes_required_update"],"nullable":true,"description":"While `phase` is `rereview`, the phase the re-review was started from. `null` otherwise."},"derivedFromLegacy":{"type":"boolean","description":"`true` when `phase` was derived from legacy review state instead of stored new-flow state."},"draftForm":{"type":"object","additionalProperties":false,"description":"The new review form. Every field is optional — any partial state is a valid auto-save; completeness is enforced by the client before submitting, not by the server. Link formats are checked when submitting: documentation links must be `http(s)` URLs and scenario links must point at a scenario of this zone (`https://<zone web domain>/<teamId>/scenarios/<scenarioId>/edit`).","properties":{"vendorRelationship":{"type":"string","enum":["direct","agreement","none"],"description":"The developer's relationship to the vendor of the integrated software."},"listingType":{"type":"string","enum":["verified","community"],"description":"Requested Marketplace listing type. The choice is only offered to Solution Partners without a vendor agreement."},"partnerProgramApplication":{"type":"string","enum":["technology","solution"],"description":"Make partner program the developer applies for together with this review, agreeing to the Make terms and conditions; omitted when not applying. Offered only to developers who are not Make partners yet, for the program their vendor relationship makes them eligible for: `none` → `solution`, otherwise `technology`."},"testScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Scenarios where the review team can see every module of the app run successfully. Each must be a scenario link of this zone when submitting."},"errorHandlingScenarioUrl":{"type":"string","maxLength":2048,"description":"Scenario that fails on purpose, demonstrating how the app surfaces an API error. Must be a scenario link of this zone when submitting."},"apiDocsUrl":{"type":"string","maxLength":2048,"description":"Documentation of the API the app calls. Must be an `http(s)` URL when submitting."},"homepageUrl":{"type":"string","maxLength":2048,"description":"Homepage of the integrated software, shown on the app's landing page. Must be an `http(s)` URL when submitting."},"categories":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":128},"description":"Marketplace categories the app belongs to."},"subcategories":{"type":"object","additionalProperties":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":128}},"description":"Selected subcategories, keyed by category."},"shortDescription":{"type":"string","maxLength":1024,"description":"Community listing only — short description of the app."},"pricing":{"type":"string","enum":["free","paid"],"description":"Community listing only — whether the app itself is free or paid."},"landingPageUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's own landing page. Must be an `http(s)` URL when submitting."},"appDocsUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's documentation. Must be an `http(s)` URL when submitting."},"dataProcessingDescription":{"type":"string","maxLength":10000,"description":"Community listing only — how the app processes data. The developer is liable for this text."},"termsConsent":{"type":"boolean","description":"Community listing only — consent to the Make Apps Marketplace terms and conditions."},"supportContactName":{"type":"string","maxLength":255,"description":"Name Make forwards support and maintenance requests to."},"supportContactEmail":{"type":"string","maxLength":255,"description":"Email Make forwards support and maintenance requests to."},"trademarkConsent":{"type":"boolean","description":"Trademark compliance declaration."},"externalTcConsent":{"type":"boolean","description":"External service terms compliance declaration."},"whatChanged":{"type":"string","maxLength":10000,"description":"Update/re-review only — what changed in this version, or what was changed in response to the reviewer."},"updatedScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Update/re-review only — the test scenarios for the change, seeded from the approved submission. Each must be a scenario link of this zone when submitting."},"reRunConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that every scenario was re-run on the current app version."},"contactsConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that the developer and support contacts are up to date."}}},"submittedForm":{"nullable":true,"allOf":[{"type":"object","additionalProperties":false,"description":"The new review form. Every field is optional — any partial state is a valid auto-save; completeness is enforced by the client before submitting, not by the server. Link formats are checked when submitting: documentation links must be `http(s)` URLs and scenario links must point at a scenario of this zone (`https://<zone web domain>/<teamId>/scenarios/<scenarioId>/edit`).","properties":{"vendorRelationship":{"type":"string","enum":["direct","agreement","none"],"description":"The developer's relationship to the vendor of the integrated software."},"listingType":{"type":"string","enum":["verified","community"],"description":"Requested Marketplace listing type. The choice is only offered to Solution Partners without a vendor agreement."},"partnerProgramApplication":{"type":"string","enum":["technology","solution"],"description":"Make partner program the developer applies for together with this review, agreeing to the Make terms and conditions; omitted when not applying. Offered only to developers who are not Make partners yet, for the program their vendor relationship makes them eligible for: `none` → `solution`, otherwise `technology`."},"testScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Scenarios where the review team can see every module of the app run successfully. Each must be a scenario link of this zone when submitting."},"errorHandlingScenarioUrl":{"type":"string","maxLength":2048,"description":"Scenario that fails on purpose, demonstrating how the app surfaces an API error. Must be a scenario link of this zone when submitting."},"apiDocsUrl":{"type":"string","maxLength":2048,"description":"Documentation of the API the app calls. Must be an `http(s)` URL when submitting."},"homepageUrl":{"type":"string","maxLength":2048,"description":"Homepage of the integrated software, shown on the app's landing page. Must be an `http(s)` URL when submitting."},"categories":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":128},"description":"Marketplace categories the app belongs to."},"subcategories":{"type":"object","additionalProperties":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":128}},"description":"Selected subcategories, keyed by category."},"shortDescription":{"type":"string","maxLength":1024,"description":"Community listing only — short description of the app."},"pricing":{"type":"string","enum":["free","paid"],"description":"Community listing only — whether the app itself is free or paid."},"landingPageUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's own landing page. Must be an `http(s)` URL when submitting."},"appDocsUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's documentation. Must be an `http(s)` URL when submitting."},"dataProcessingDescription":{"type":"string","maxLength":10000,"description":"Community listing only — how the app processes data. The developer is liable for this text."},"termsConsent":{"type":"boolean","description":"Community listing only — consent to the Make Apps Marketplace terms and conditions."},"supportContactName":{"type":"string","maxLength":255,"description":"Name Make forwards support and maintenance requests to."},"supportContactEmail":{"type":"string","maxLength":255,"description":"Email Make forwards support and maintenance requests to."},"trademarkConsent":{"type":"boolean","description":"Trademark compliance declaration."},"externalTcConsent":{"type":"boolean","description":"External service terms compliance declaration."},"whatChanged":{"type":"string","maxLength":10000,"description":"Update/re-review only — what changed in this version, or what was changed in response to the reviewer."},"updatedScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Update/re-review only — the test scenarios for the change, seeded from the approved submission. Each must be a scenario link of this zone when submitting."},"reRunConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that every scenario was re-run on the current app version."},"contactsConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that the developer and support contacts are up to date."}}}],"description":"Snapshot of `draftForm` taken at the last submit. Later draft edits do not change it."},"submittedAt":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of the last submit."},"events":{"type":"array","description":"Review history timeline, oldest first.","items":{"type":"object","properties":{"type":{"type":"string","description":"Event type. Developer-side (`actor: developer`): `preparation_started`, `submitted`, `cancelled`, `submission_withdrawn`, `auto_notes_confirmed`, `rereview_started`, `rereview_cancelled`, `resubmitted`, `update_started`, `update_submitted`, `update_withdrawn`, `update_cancelled`. Make-side (`actor: make`, with an optional `note`): `auto_notes_sent`, `approved`, `changes_requested`, `update_approved`, `update_changes_requested`."},"actor":{"type":"string","enum":["developer","make"],"description":"Which side of the review produced the event."},"note":{"type":"string","description":"Optional free-text detail (e.g. the reviewer's request). Omitted when empty."},"createdAt":{"type":"string","format":"date-time","description":"When the event happened."}}}},"updatedAt":{"type":"string","format":"date-time","nullable":true,"description":"Last modification of the new-flow state. `null` while no new-flow row exists."}}}}}}}},"400":{"description":"The note is missing or empty.","content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"The caller is not an administrator with the `apps edit` permission.","content":{"application/json":{"schema":{"type":"object"}}}},"409":{"description":"Nothing is in review.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Send the automatic-review notes (reviewer)

> Hands the automatic-review notes of the submission waiting with Make to the developer: while the phase is \`review\` or \`update\_review\` with \`reviewStep: manual\`, the step moves to \`auto\` and an \`auto\_notes\_sent\` event is appended, carrying the optional \`note\`. The developer then implements the notes and confirms them (\`POST /sdk/apps/{SDK\_appName}/{SDK\_appVersion}/app-review/confirm-auto-notes\`), which hands the submission back (\`manual\`). The phase itself does not change, and the outcomes (\`approve\`, \`request-changes\`) stay available in both steps. Fails with \`409\` while notes are already waiting for the developer (\`reviewStep: auto\`) and in any other phase.\
> This only records that the notes were sent — the notes themselves reach the developer by email from Make's app review process, or as the \`note\`.\
> Requires an administrator with the \`apps edit\` permission (the same one the legacy reviewer status form needs). Available only while the \`is\_sdk\_app\_review\_enabled\` feature flag is on, otherwise responds with \`400\` (IM903).

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["admin:write","sdk-apps:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/admin/sdk/apps/{app}/{version}/app-review/send-auto-notes":{"post":{"tags":["Admin / SDK Apps / Review"],"summary":"Send the automatic-review notes (reviewer)","description":"Hands the automatic-review notes of the submission waiting with Make to the developer: while the phase is `review` or `update_review` with `reviewStep: manual`, the step moves to `auto` and an `auto_notes_sent` event is appended, carrying the optional `note`. The developer then implements the notes and confirms them (`POST /sdk/apps/{SDK_appName}/{SDK_appVersion}/app-review/confirm-auto-notes`), which hands the submission back (`manual`). The phase itself does not change, and the outcomes (`approve`, `request-changes`) stay available in both steps. Fails with `409` while notes are already waiting for the developer (`reviewStep: auto`) and in any other phase.\nThis only records that the notes were sent — the notes themselves reach the developer by email from Make's app review process, or as the `note`.\nRequires an administrator with the `apps edit` permission (the same one the legacy reviewer status form needs). Available only while the `is_sdk_app_review_enabled` feature flag is on, otherwise responds with `400` (IM903).","parameters":[{"name":"app","in":"path","schema":{"type":"string"},"required":true,"description":"Name of the SDK app."},{"name":"version","in":"path","schema":{"type":"integer"},"required":true,"description":"Major version of the SDK app."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"note":{"type":"string","minLength":1,"maxLength":10000,"description":"Optional notes for the developer, stored on the timeline event the developer sees."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"review":{"type":"object","description":"State of the new SDK app review flow for one app version. The lifecycle phase either comes from the new flow's own storage or, while the new flow has never touched the app (`derivedFromLegacy: true`), is derived from the legacy review state (`approved`/`in_review` flags and the legacy review status). Every lifecycle step is traced to Trackman with the legacy event closest to it: the submission that requests the review as `apps_review_requested`, every other step (including the reviewer's) as `apps_review_form_updated`, whose `review_form.event` is the timeline event the step appended. Auto-saving the draft (`PUT …/app-review/form`) is not a step and is not traced.","properties":{"appName":{"type":"string","description":"Name of the SDK app."},"appVersion":{"type":"integer","description":"Major version of the SDK app."},"phase":{"type":"string","enum":["dormant","preparing","review","changes_required","approved","updating","update_review","changes_required_update","rereview"],"description":"Lifecycle phase of the review. `dormant` → `start` → `preparing` → `submit` → `review`; a reviewer then approves (`approved`) or requests changes (`changes_required`, reopened with `start-rereview` → `rereview` → `submit` back to `review`). An approved listing is updated through `start-update` → `updating` → `submit` → `update_review`, whose outcomes are `approved` or `changes_required_update` (re-reviewed through `rereview` back to `update_review`). `cancel` steps back one phase on every track."},"reviewStep":{"type":"string","enum":["auto","manual"],"nullable":true,"description":"Sub-step while `phase` is `review`/`update_review` — `manual` means the submission waits with Make (where every submission starts), `auto` means Make sent the automatic-review notes and waits on the developer to implement and confirm them. `null` in every other phase."},"rereviewOrigin":{"type":"string","enum":["changes_required","changes_required_update"],"nullable":true,"description":"While `phase` is `rereview`, the phase the re-review was started from. `null` otherwise."},"derivedFromLegacy":{"type":"boolean","description":"`true` when `phase` was derived from legacy review state instead of stored new-flow state."},"draftForm":{"type":"object","additionalProperties":false,"description":"The new review form. Every field is optional — any partial state is a valid auto-save; completeness is enforced by the client before submitting, not by the server. Link formats are checked when submitting: documentation links must be `http(s)` URLs and scenario links must point at a scenario of this zone (`https://<zone web domain>/<teamId>/scenarios/<scenarioId>/edit`).","properties":{"vendorRelationship":{"type":"string","enum":["direct","agreement","none"],"description":"The developer's relationship to the vendor of the integrated software."},"listingType":{"type":"string","enum":["verified","community"],"description":"Requested Marketplace listing type. The choice is only offered to Solution Partners without a vendor agreement."},"partnerProgramApplication":{"type":"string","enum":["technology","solution"],"description":"Make partner program the developer applies for together with this review, agreeing to the Make terms and conditions; omitted when not applying. Offered only to developers who are not Make partners yet, for the program their vendor relationship makes them eligible for: `none` → `solution`, otherwise `technology`."},"testScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Scenarios where the review team can see every module of the app run successfully. Each must be a scenario link of this zone when submitting."},"errorHandlingScenarioUrl":{"type":"string","maxLength":2048,"description":"Scenario that fails on purpose, demonstrating how the app surfaces an API error. Must be a scenario link of this zone when submitting."},"apiDocsUrl":{"type":"string","maxLength":2048,"description":"Documentation of the API the app calls. Must be an `http(s)` URL when submitting."},"homepageUrl":{"type":"string","maxLength":2048,"description":"Homepage of the integrated software, shown on the app's landing page. Must be an `http(s)` URL when submitting."},"categories":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":128},"description":"Marketplace categories the app belongs to."},"subcategories":{"type":"object","additionalProperties":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":128}},"description":"Selected subcategories, keyed by category."},"shortDescription":{"type":"string","maxLength":1024,"description":"Community listing only — short description of the app."},"pricing":{"type":"string","enum":["free","paid"],"description":"Community listing only — whether the app itself is free or paid."},"landingPageUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's own landing page. Must be an `http(s)` URL when submitting."},"appDocsUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's documentation. Must be an `http(s)` URL when submitting."},"dataProcessingDescription":{"type":"string","maxLength":10000,"description":"Community listing only — how the app processes data. The developer is liable for this text."},"termsConsent":{"type":"boolean","description":"Community listing only — consent to the Make Apps Marketplace terms and conditions."},"supportContactName":{"type":"string","maxLength":255,"description":"Name Make forwards support and maintenance requests to."},"supportContactEmail":{"type":"string","maxLength":255,"description":"Email Make forwards support and maintenance requests to."},"trademarkConsent":{"type":"boolean","description":"Trademark compliance declaration."},"externalTcConsent":{"type":"boolean","description":"External service terms compliance declaration."},"whatChanged":{"type":"string","maxLength":10000,"description":"Update/re-review only — what changed in this version, or what was changed in response to the reviewer."},"updatedScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Update/re-review only — the test scenarios for the change, seeded from the approved submission. Each must be a scenario link of this zone when submitting."},"reRunConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that every scenario was re-run on the current app version."},"contactsConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that the developer and support contacts are up to date."}}},"submittedForm":{"nullable":true,"allOf":[{"type":"object","additionalProperties":false,"description":"The new review form. Every field is optional — any partial state is a valid auto-save; completeness is enforced by the client before submitting, not by the server. Link formats are checked when submitting: documentation links must be `http(s)` URLs and scenario links must point at a scenario of this zone (`https://<zone web domain>/<teamId>/scenarios/<scenarioId>/edit`).","properties":{"vendorRelationship":{"type":"string","enum":["direct","agreement","none"],"description":"The developer's relationship to the vendor of the integrated software."},"listingType":{"type":"string","enum":["verified","community"],"description":"Requested Marketplace listing type. The choice is only offered to Solution Partners without a vendor agreement."},"partnerProgramApplication":{"type":"string","enum":["technology","solution"],"description":"Make partner program the developer applies for together with this review, agreeing to the Make terms and conditions; omitted when not applying. Offered only to developers who are not Make partners yet, for the program their vendor relationship makes them eligible for: `none` → `solution`, otherwise `technology`."},"testScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Scenarios where the review team can see every module of the app run successfully. Each must be a scenario link of this zone when submitting."},"errorHandlingScenarioUrl":{"type":"string","maxLength":2048,"description":"Scenario that fails on purpose, demonstrating how the app surfaces an API error. Must be a scenario link of this zone when submitting."},"apiDocsUrl":{"type":"string","maxLength":2048,"description":"Documentation of the API the app calls. Must be an `http(s)` URL when submitting."},"homepageUrl":{"type":"string","maxLength":2048,"description":"Homepage of the integrated software, shown on the app's landing page. Must be an `http(s)` URL when submitting."},"categories":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":128},"description":"Marketplace categories the app belongs to."},"subcategories":{"type":"object","additionalProperties":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":128}},"description":"Selected subcategories, keyed by category."},"shortDescription":{"type":"string","maxLength":1024,"description":"Community listing only — short description of the app."},"pricing":{"type":"string","enum":["free","paid"],"description":"Community listing only — whether the app itself is free or paid."},"landingPageUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's own landing page. Must be an `http(s)` URL when submitting."},"appDocsUrl":{"type":"string","maxLength":2048,"description":"Community listing only — the app's documentation. Must be an `http(s)` URL when submitting."},"dataProcessingDescription":{"type":"string","maxLength":10000,"description":"Community listing only — how the app processes data. The developer is liable for this text."},"termsConsent":{"type":"boolean","description":"Community listing only — consent to the Make Apps Marketplace terms and conditions."},"supportContactName":{"type":"string","maxLength":255,"description":"Name Make forwards support and maintenance requests to."},"supportContactEmail":{"type":"string","maxLength":255,"description":"Email Make forwards support and maintenance requests to."},"trademarkConsent":{"type":"boolean","description":"Trademark compliance declaration."},"externalTcConsent":{"type":"boolean","description":"External service terms compliance declaration."},"whatChanged":{"type":"string","maxLength":10000,"description":"Update/re-review only — what changed in this version, or what was changed in response to the reviewer."},"updatedScenarioUrls":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2048},"description":"Update/re-review only — the test scenarios for the change, seeded from the approved submission. Each must be a scenario link of this zone when submitting."},"reRunConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that every scenario was re-run on the current app version."},"contactsConfirmed":{"type":"boolean","description":"Update/re-review only — confirmation that the developer and support contacts are up to date."}}}],"description":"Snapshot of `draftForm` taken at the last submit. Later draft edits do not change it."},"submittedAt":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of the last submit."},"events":{"type":"array","description":"Review history timeline, oldest first.","items":{"type":"object","properties":{"type":{"type":"string","description":"Event type. Developer-side (`actor: developer`): `preparation_started`, `submitted`, `cancelled`, `submission_withdrawn`, `auto_notes_confirmed`, `rereview_started`, `rereview_cancelled`, `resubmitted`, `update_started`, `update_submitted`, `update_withdrawn`, `update_cancelled`. Make-side (`actor: make`, with an optional `note`): `auto_notes_sent`, `approved`, `changes_requested`, `update_approved`, `update_changes_requested`."},"actor":{"type":"string","enum":["developer","make"],"description":"Which side of the review produced the event."},"note":{"type":"string","description":"Optional free-text detail (e.g. the reviewer's request). Omitted when empty."},"createdAt":{"type":"string","format":"date-time","description":"When the event happened."}}}},"updatedAt":{"type":"string","format":"date-time","nullable":true,"description":"Last modification of the new-flow state. `null` while no new-flow row exists."}}}}}}}},"403":{"description":"The caller is not an administrator with the `apps edit` permission.","content":{"application/json":{"schema":{"type":"object"}}}},"409":{"description":"Notes are already waiting for the developer, or nothing is in review.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.make.com/white-label-documentation/admin-api-reference/admin-sdk-apps-review.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
