---
title: "Set app logo"
method: POST
path: "/api/apps/{app_id}/metadata/update-logo"
---

# Set app logo

`POST /api/apps/{app_id}/metadata/update-logo`

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

Sets the app's logo to the image at `logo_url`.

The URL is stored as you send it. It isn't fetched or checked, so use a link that stays reachable, such as the public link from [Upload app file](/api-reference/upload-app-file). The builder shows the new logo right away, and the published app shows it after you next [deploy the app](/api-reference/deploy-an-app). Link previews use the logo when the app has no social image.

Generating a logo is limited to 10 requests an hour per app. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app. A read-only key is refused, and workspace API keys are not accepted.</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. Send only the fields documented here. Other request fields are not supported and their behavior can change.</Warning>

## Path parameters

- `app_id` string, required — ID of the app to set the logo on.

## Request body

- object
  - `logo_url` string, required — URL of the image to use as the app's logo.

## Response `200`

The app with its new logo.

- AppLogo — Doc-only: the handler returns the whole app document.
  - `id` string, required — ID of the app.
  - `logo_url` string, required — URL of the app's logo, as you sent it.

## Other responses

- `400` — `logo_url` is missing.
- `401` — Missing or invalid credentials.
- `403` — You don't have editor access to this app, or your API key is read-only.
- `404` — App not found.
- `422` — Validation Error
- `429` — Rate limit reached. Retry later.

## Changes

> 18 revisions in range; 1 not diffed.

- **2026-09-28** `28fc82924122` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/metadata/update-logo/post.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/28fc82924122?raw)