---
title: "Creates a new application"
method: POST
path: "/app"
tags: ["App", "AppVersion"]
---

# Creates a new application

`POST /app`

## Request body

- AppCreate
  - `deploymentStatus` 'dev' | 'test' | 'prod' — Identifies if an application is in development, test, or production.
  - `contactEmail` string, email — Contact email for the application manager
  - `appUserUrl` string, uri — This should be a landing page for the app.
  - `logo` string — Base64 encoded logo image
  - `redirectUris` string[] — Redirect URIs users can be sent to after signing up for your application (with their JWT token).
  - `delegateeAddresses` string[] — Addresses responsible for executing the app's operations on behalf of Vincent App Users
  - `name` string, required — The name of the application
  - `description` string, required — Description of the application

## Response `200`

Successful operation

- App
  - `_id` string, required — Document ID
  - `updatedAt` string, date-time, required — Timestamp when this was last modified
  - `createdAt` string, date-time, required — Timestamp when this was created
  - `appId` number, required — Application ID
  - `activeVersion` number — Active version of the application
  - `name` string, required — The name of the application
  - `description` string, required — Description of the application
  - `contactEmail` string, email — Contact email for the application manager
  - `appUserUrl` string, uri — This should be a landing page for the app.
  - `logo` string — Base64 encoded logo image
  - `redirectUris` string[] — Redirect URIs users can be sent to after signing up for your application (with their JWT token).
  - `delegateeAddresses` string[] — Addresses responsible for executing the app's operations on behalf of Vincent App Users
  - `deploymentStatus` 'dev' | 'test' | 'prod' — Identifies if an application is in development, test, or production.
  - `managerAddress` string, required — App manager's wallet address. Derived from the authorization signature provided by the creator.
  - `isDeleted` boolean — Whether or not this App is deleted

## Other responses

- `400` — Invalid input
- `422` — Validation exception
- `default` — Unexpected error

## Changes

- **2025-07-23** `246a15ffe975` — 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `siweAuth` was removed from the API
- **2025-07-10** `53380a49f00f` — 2 info
  - added the new optional request property `delegateeAddresses`
  - added the optional property `delegateeAddresses` to the response with the `200` status
- **2025-07-02** `cfdc102dddd1` — 1 info
  - added the optional property `isDeleted` to the response with the `200` status
- **2025-07-02** `433f98e35cde` — 3 breaking, 1 info
  - the request property `description` became required
  - the `description` request property's minLength was increased from `0` to `10`
  - the `name` request property's minLength was increased from `0` to `2`
  - the response property `description` became required for the status `200`
- **2025-06-28** `f36ee26d6286` — 1 warning, 1 info
  - removed the request property `managerAddress`
  - the response required property `managerAddress` became read-only for the status `200`

[Full history](https://skmtc.dev/lit-protocol/apis/vincent-registry-api/changes/app/post.md)

---

[API](https://skmtc.dev/lit-protocol/apis/vincent-registry-api.md) · [All operations](https://skmtc.dev/lit-protocol/apis/vincent-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lit-protocol/vincent-registry-api/revisions/2d8f96fba2d3/schema)