Get template listing pending update

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Shows whether an update to a template listing is waiting for review, and which listing details it changes. Check it after you submit an update to a public template. A workspace template never has one waiting, because its updates apply right away.

Get it from catalog_items in Check app delete impact.

You need to be an owner or admin of the app's workspace. For a listing shared only within a workspace, you need to be an owner or admin of that workspace.

This endpoint is limited to 60 requests a minute per caller.

<Note>This endpoint accepts a personal API key, including a read-only key.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

get/api/app-catalog-items/catalog/{item_id}/pending-changes

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/app-catalog-items/catalog/{item_id}/pending-changes
  • Auth: HTTP bearer

Path parameters

item_idstring required

ID of the template listing. Get it from catalog_items in Check app delete impact.

Response

What's waiting for review.

has_pending_updateboolean required

Whether an update is waiting for review.

has_code_changesboolean required

Whether the pending update includes a new copy of the app.

has_metadata_changesboolean required

Whether the pending update changes listing details.

metadata_diffobject required

Each listing detail the update changes, keyed by field name. Empty when it changes none.

Example response

{
  "has_pending_update": true,
  "has_code_changes": true,
  "has_metadata_changes": true,
  "metadata_diff": {
    "version": {
      "new": "1.1.0",
      "old": "1.0.0"
    }
  }
}

Changes

    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API