Submit template listing update

Changed on

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

Sends the app's current state, and optionally new listing details, as an update to its approved template listing. It's the Submit update button in the app's template settings.

The update copies the app as it is in the editor, including changes you haven't published. Publishing with Deploy an app doesn't change what goes in.

What happens next depends on the listing:

  • A workspace template updates right away.
  • A public template goes to Base44 for review. The current version stays live until the update is approved. Submitting again replaces an update that's still waiting, including its listing details.

Only an approved listing that isn't archived can be updated. An app that uses a custom connector can't be submitted, because a custom connector works only in the workspace that built it. Get it from catalog_items in Check app delete impact.

Submitting an update is limited to 10 requests a minute per caller.

<Note>This endpoint accepts a personal API key. A read-only key is refused.</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>

post/api/app-catalog-items/catalog/{item_id}/submit-update

Request

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

Path parameters

item_idstring required

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

Request body

Example request

{
  "metadata": {
    "version": "1.1.0",
    "changelog": "Adds a reports page."
  }
}

Response

The update was submitted.

idstring required

ID of the template listing.

app_idstring required

ID of the app the listing was made from.

namestring required

Name of the listing. For a public template, a new name waits in pending_metadata until the update is approved.

statusstring required

Review status of the listing. Stays approved, because the current version stays live.

visibility_scopestring required

public for a listing in the Base44 template gallery, or workspace for one shared only within the app's workspace.

pending_metadataobject nullable required

Listing details waiting for review, or null when none are. Always null for a workspace template, whose changes apply right away.

Example response

{
  "id": "68b2f0c1a4d9e7001c3b5a22",
  "app_id": "6820f3a4e7b91d003c45a1f2",
  "name": "CRM starter",
  "status": "approved",
  "visibility_scope": "workspace",
  "pending_metadata": {
    "version": "1.1.0"
  },
  "_update_info": {
    "has_code_changes": true,
    "auto_approved": true
  }
}

Changes