Skip to main content
PUT
Update app

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

Body

application/json
name
string

New name for the app.

Example:

"Nordwind Furniture"

user_description
string | null

New description for the app, or null to remove it.

Example:

"An online catalog and order tracker for a furniture workshop."

Response

The app, with its new details.

An app in a workspace, limited to the properties the caller requested.

created_by
string | null

Email of the user who created the app.

Example:

"developer@example.com"

created_date
string<date-time> | null

Time the app was created, as a UTC timestamp in ISO 8601 format.

Example:

"2026-08-01T09:15:00"

first_prompt_model_comparison
FirstPromptModelComparisonPublicState · object | null

Accepted first-prompt model comparison, including its durable comparison ID.

id
string | null

ID of the app.

Example:

"6820f3a4e7b91d003c45a1f2"

last_deployed_at
string<date-time> | null

Time the app was last published, as a UTC timestamp in ISO 8601 format, or null if it has never been published.

Example:

"2026-08-02T14:30:00"

name
string | null

Display name of the app.

Example:

"My CRM"

preview_screenshot_url
string | null

URL of a preview screenshot taken before publishing, distinct from screenshot_url, or null if none has been captured.

Example:

"https://storage.base44.com/previews/6820f3a4e7b91d003c45a1f2.png"

screenshot_url
string | null

URL of a screenshot of the published app. Captured shortly after each publish, so it can briefly lag or be null right after publishing.

Example:

"https://storage.base44.com/screenshots/6820f3a4e7b91d003c45a1f2.png"

slug
string | null

URL slug for the app, auto generated from the name and app ID or set to a custom value, or null if the app has no slug yet. The published URL is built from it.

Example:

"my-crm-3c45a1f2"

status
AppStatusResponse · object | null

The app's current build status. Poll while a build is in progress to watch it finish. This tracks building, not publishing.

updated_date
string<date-time> | null

Time the app document was last written, as a UTC timestamp in ISO 8601 format.

Example:

"2026-08-02T14:30:00"

user_description
string | null

Description of the app, or null if none was set. On a newly created app this holds the original prompt text.

Example:

"A CRM to track leads and deals"