> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/wix-backoffice/dev-center-platform/apps/introduction.md

## Article Content:

# About the Apps API

The [Apps API](https://dev.wix.com/docs/api-reference/app-management/apps/introduction.md) lets developer tools create and configure Wix apps. Use it to prepare an app's identity and configuration before adding functionality or preparing a release.

With the Apps API, you can:

- Create apps and update their names and installation preferences.
- Retrieve app configuration and assign namespaces and slugs.
- Retrieve app secrets with the required authorization.

## Apps and their building blocks

An app provides the shared identity for its components, permissions, webhooks, dependencies, and versions. Use its `id` when working with these related App Management APIs:

- Components manages pages, widgets, and other app extensions.
- [App Permissions](https://dev.wix.com/docs/api-reference/app-management/app-permissions.md) manages the Wix resources the app can access. Permission changes can take up to 5 minutes to appear across the Wix ecosystem.
- Webhooks manages subscriptions to Wix events.
- Dependencies manages other apps required by the app.
- App Versions manages draft and published versions.

Creating or updating the app's configuration doesn't publish an app version or install the app on a site.

## Before you begin

It's important to note the following points before starting to code:

- Keep app secrets in secure backend storage. Don't include them in frontend code, source control, or logs.
- Get App omits secrets by default. Include `APP_SECRETS` in `additionalFields` to retrieve them with the required authorization.
- App configuration, app publication, and app installation are separate workflows. This API covers app configuration.
- Retain the `app.id` returned when creating an app. This API has no public methods to list or delete apps.
- Apps intended for the Wix App Market should have names of no more than 30 characters. The API accepts up to 50 characters.
- `appUrls.appUri` and `appUrls.redirectUris` configure Advanced OAuth, whose use is highly discouraged. See [Advanced OAuth](https://dev.wix.com/docs/build-apps/develop-your-app/auth/custom-authentication-deprecated.md).
- Unreleased-change flags are calculated automatically, update asynchronously and don't track every change. Permission deletions and component-translation creation events currently aren't reflected in their corresponding flags.

## Use cases

- [Create and configure an app for development](https://dev.wix.com/docs/api-reference/app-management/apps/sample-flows.md).

## Terminology

- App: An extension built for Wix, with its own identity, configuration, and building blocks.
- Display name: The human-readable name shown to users.
- Namespace: An identifier combining an account or company identifier with an app-name component, such as `@example-company/bookings-helper`.
- Slug: A human-readable, URL-friendly identifier for the app.
- Code identifier: An identifier used to reference the app in code. Reserved JavaScript words aren't rejected; choose a non-reserved value when using it as a variable name. Companion apps share the value `companionApp`, so use the app ID when a unique identifier is needed.
- Companion app: An app assigned to a specific site or account.

