Skip to content

Privacy and analytics

We use necessary technical cookies and, only with your consent, analytics and marketing pixels to improve the website and measure campaigns.

Privacy policyCookie policy
Docs
GuidesDevelopers
English
EspañolEnglishFrançaisDeutschItalianoPortuguês
API/Brand API
Reference3 min read

Apps

The brand’s landings, websites and shops inside its Brand OS: their status, addresses and modules.

On this page

Start building

  • Your first API call
  • Limits, versions and headers

API

  • Brand API
    • Errors
    • Permissions and roles
    • Events and webhooks
    • Brand
    • Genome
    • Brand Kit
    • Library
    • Works
    • Calendar
    • Connections
    • Publishing
    • Inbox
    • Team
    • Account and team
    • Conversation
    • Memory
    • Questions
    • Media
    • Store
    • Plan
    • Orders
    • Activity
    • Workspace
    • Your account
    • Billing
    • Sync
    • Website and domains
    • Statistics
    • Mailing
    • Media
    • Apps
    • Events

MCP

  • MCP server

Connectors

  • Brand connectors
Русский
한국어
日本語
中文
हिन्दी
Open the app
  • apps.list · Brand Apps
  • apps.get · One App
  • apps.create · Create an App
  • apps.update · Update an App
  • apps.pages.list · Pages of an App
  • apps.pages.get · One page
  • apps.pages.create · Create a page
  • apps.pages.update · Save a page
  • apps.pages.trash · Delete a page
  • apps.pages.restore · Restore a page

The exact input and output of each operation are in /api/v1/openapi.json with your token, or from an agent with nomad_describe.

apps.list · Brand Apps

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/apps.list
MCP toolapps_list
Scopeapps.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

apps.get · One App

One of the brand’s Apps with its status, addresses and modules. Answers not_found for an App of another brand.

FieldValue
KindRead
HTTP methodPOST /api/v1/apps.get
MCP toolapps_get
Scopeapps.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

apps.create · Create an App

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).

FieldValue
KindWrite
HTTP methodPOST /api/v1/apps.create
MCP toolapps_create
Scopeapps.write
Minimum roleMember
Human confirmationYes
DoorsScreens
StatusAvailable

apps.update · Update an App

Renames an App. Its addresses, modules and content do not change.

FieldValue
KindWrite
HTTP methodPOST /api/v1/apps.update
MCP toolapps_update
Scopeapps.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

apps.pages.list · Pages of an App

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/apps.pages.list
MCP toolapps_pages_list
Scopeapps.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

apps.pages.get · One page

One page of an App with its SEO and its blocks (the page document).

FieldValue
KindRead
HTTP methodPOST /api/v1/apps.pages.get
MCP toolapps_pages_get
Scopeapps.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

apps.pages.create · Create a page

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).

FieldValue
KindWrite
HTTP methodPOST /api/v1/apps.pages.create
MCP toolapps_pages_create
Scopeapps.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

apps.pages.update · Save a page

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 /.

FieldValue
KindWrite
HTTP methodPOST /api/v1/apps.pages.update
MCP toolapps_pages_update
Scopeapps.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

apps.pages.trash · Delete a page

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).

FieldValue
KindWrite
HTTP methodPOST /api/v1/apps.pages.trash
MCP toolapps_pages_trash
Scopeapps.write
Minimum roleMember
Human confirmationYes
DoorsScreens
StatusAvailable

apps.pages.restore · Restore a page

Takes a page out of the trash with its blocks. If its path was taken meanwhile it answers conflict (app_page_path_taken).

FieldValue
KindWrite
HTTP methodPOST /api/v1/apps.pages.restore
MCP toolapps_pages_restore
Scopeapps.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable
PreviousMediaNextEvents

In this section

  • Errors
  • Permissions and roles
  • Events and webhooks
  • Brand
Can't find what you need? Write to usWrite to usGo to the app
© 2026 Nömad · Nömad documentationLinkedInInstagramThreadsFacebookTikTokYouTubeX
Go to nomad.oooBack to top

On this page

  • apps.list · Brand Apps
  • apps.get · One App
  • apps.create · Create an App
  • apps.update · Update an App
  • apps.pages.list · Pages of an App
  • apps.pages.get · One page
  • apps.pages.create · Create a page
  • apps.pages.update · Save a page
  • apps.pages.trash · Delete a page
  • apps.pages.restore · Restore a page
Genome
  • Brand Kit
  • Library
  • Works