---
title: "Update public HTML-shell metadata immediately, without AI, code edits, publishing or Saved Versions"
method: POST
path: "/api/mcp/tools/set_app_metadata"
tags: ["tools"]
---

# Update public HTML-shell metadata immediately, without AI, code edits, publishing or Saved Versions

`POST /api/mcp/tools/set_app_metadata`

## Request

- Base URL: `https://finestructure.ai`
- URL: `https://finestructure.ai/api/mcp/tools/set_app_metadata`
- Auth: HTTP bearer

Update public HTML-shell metadata immediately, without AI, code edits, publishing or Saved Versions. Upload social_image/icon as base64 PNG/JPEG/WebP (max 5 MB, 4096px); null clears an image. Language sets HTML lang/dir and OG locale. For per-page cards, write optional seo.json and publish it; dynamic entries may read only explicitly public entity records.

## Request body

- object
  - `app_id` string, required
  - `name` string
  - `description` string
  - `language` string: BCP-47 code, e.g. he, ar, en-US
  - `social_image` object, nullable
    - `base64` string, required
    - `content_type` 'image/png' | 'image/jpeg' | 'image/webp', required
  - `icon` object, nullable
    - `base64` string, required
    - `content_type` 'image/png' | 'image/jpeg' | 'image/webp', required
  - `structured_data` string: Optional JSON-LD JSON string; empty clears it

## Response `200`

Tool executed successfully

- ToolResult
  - `ok` boolean, required
  - `tool` string, required
  - `result` object, required

## Other responses

- `400`: Invalid arguments for this tool
- `401`: Missing or invalid bearer token
- `402`: Not enough credits on the account
- `403`: Token scope does not permit this tool
- `404`: Unknown tool name
- `429`: Rate limit exceeded, retry after the indicated delay
- `500`: Internal error while executing the tool

---

[API](https://skmtc.dev/finestructure/apis/fine-structure-api.md) · [All operations](https://skmtc.dev/finestructure/apis/fine-structure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finestructure/apis/fine-structure-api/revisions/02c50ed5fd70?raw)