---
title: "Create an application and publishable key"
method: POST
path: "/v1/applications"
tags: ["Applications"]
---

# Create an application and publishable key

`POST /v1/applications`

## Request

- Base URL: `https://api.masko.ai`
- URL: `https://api.masko.ai/v1/applications`
- Auth: HTTP bearer

Responses use Cache-Control: no-store. Application management requires the personal owner or workspace owner/admin. Existing application identities and credentials are preserved. Character playback issuance has been retired; use a backend REST key to retrieve signed canvas release delivery.

Select Masko-API-Version: 2026-09-26 (or api_version=2026-09-26) for the canonical mascot contract shown first. Existing unversioned clients keep legacy collection fields. A mascot_id query filter also selects the canonical contract. Mixing identifier names returns 400.

## Query parameters

- `api_version` '2026-09-26' | 'legacy'

## Headers

- `Idempotency-Key` string
- `Masko-API-Version` '2026-09-26' | 'legacy'

## Request body

- object
  - `name` string, required

## Response `201`

Success

- object
  - `data` object, required
    - `id` string, uuid, required
    - `name` string, required
    - `publishable_key` string, required
    - `created_at` string, date-time, required
    - `organization_id` string, uuid, nullable, required

## Other responses

- `400`: Request denied or unavailable
- `401`: Request denied or unavailable
- `403`: Request denied or unavailable
- `404`: Request denied or unavailable
- `409`: Request denied or unavailable
- `429`: Rate limited; Retry-After: 60
- `500`: Request denied or unavailable

---

[API](https://skmtc.dev/masko/apis/masko-api.md) · [All operations](https://skmtc.dev/masko/apis/masko-api/llms.txt) · [OpenAPI document](https://skmtc.dev/masko/apis/masko-api/revisions/91eb3006a92f?raw)