Apps
The brand’s landings, websites and shops inside its Brand OS: their status, addresses and modules.
Privacy and analytics
We use necessary technical cookies and, only with your consent, analytics and marketing pixels to improve the website and measure campaigns.
The brand’s landings, websites and shops inside its Brand OS: their status, addresses and modules.
The exact input and output of each operation are in /api/v1/openapi.json with your token, or from an agent with nomad_describe.
The brand’s Apps (landings, websites, shops) with their status, development address, production domain and modules. Closed Apps are left out unless includeClosed is true.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/apps.list |
| MCP tool | apps_list |
| Scope | apps.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
One of the brand’s Apps with its status, addresses and modules. Answers not_found for an App of another brand.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/apps.get |
| MCP tool | apps_get |
| Scope | apps.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Creates a draft App in the brand’s main language with the modules of its kind. It lives only on its development address until published. devSlug defaults to one made from the name; a taken slug answers conflict (app_slug_taken).
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/apps.create |
| MCP tool | apps_create |
| Scope | apps.write |
| Minimum role | Member |
| Human confirmation | Yes |
| Doors | Screens |
| Status | Available |
Renames an App. Its addresses, modules and content do not change.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/apps.update |
| MCP tool | apps_update |
| Scope | apps.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
The pages of an App with their path, status and block count, home page first. Pages in the trash are left out unless includeTrashed is true.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/apps.pages.list |
| MCP tool | apps_pages_list |
| Scope | apps.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
One page of an App with its SEO and its blocks (the page document).
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/apps.pages.get |
| MCP tool | apps_pages_get |
| Scope | apps.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Creates an empty page in an App. path defaults to one made from the title; a path already used in the App answers conflict (app_page_path_taken).
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/apps.pages.create |
| MCP tool | apps_pages_create |
| Scope | apps.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Saves a page’s title, path, SEO or blocks; each save is a new revision kept in its history. With expectedRevision, a page someone else saved meanwhile answers conflict (app_page_revision_conflict). The home page keeps /.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/apps.pages.update |
| MCP tool | apps_pages_update |
| Scope | apps.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Moves a page to the trash; apps.pages.restore brings it back with its blocks. The home page cannot be deleted (app_page_is_home).
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/apps.pages.trash |
| MCP tool | apps_pages_trash |
| Scope | apps.write |
| Minimum role | Member |
| Human confirmation | Yes |
| Doors | Screens |
| Status | Available |
Takes a page out of the trash with its blocks. If its path was taken meanwhile it answers conflict (app_page_path_taken).
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/apps.pages.restore |
| MCP tool | apps_pages_restore |
| Scope | apps.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |