---
title: "Register a platform app"
method: POST
path: "/v1/platform/apps"
tags: ["Platform"]
---

# Register a platform app

`POST /v1/platform/apps`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/platform/apps`
- Auth: HTTP bearer

Register a new platform app for building on top of 1Claw. Returns an API key (plt_ prefix) that must be saved immediately.

## Request body

- CreatePlatformAppRequest
  - `name` string, required
  - `slug` string, required
  - `description` string
  - `oidc_jwks_url` string, uri
  - `oidc_issuer` string, uri
  - `oidc_audience` string: Expected audience claim for OIDC token validation
  - `redirect_uris` string[]
  - `billing_model` 'platform_pays' | 'user_pays' | 'hybrid'
  - `auth_mode` 'silent' | 'user_signin' | 'configurable'
  - `max_connected_users` integer, nullable
  - `api_key_expires_at` string, date-time, nullable: Optional expiration time for the platform API key.

## Response `201`

Platform app created

- PlatformAppCreatedResponse
  - `id` string, uuid
  - `name` string
  - `slug` string
  - `description` string
  - `logo_url` string, nullable
  - `api_key_prefix` string
  - `oidc_jwks_url` string, nullable
  - `oidc_issuer` string, nullable
  - `oidc_audience` string, nullable: Expected audience claim for OIDC token validation
  - `redirect_uris` string[]
  - `webhook_url` string, nullable
  - `is_active` boolean
  - `billing_model` string
  - `auth_mode` string
  - `max_connected_users` integer, nullable
  - `connected_users` integer
  - `api_key_expires_at` string, date-time, nullable: When the platform API key expires.
  - `api_key_rotated_at` string, date-time, nullable: When the platform API key was last rotated.
  - `siwe_domain` string, nullable: Hostname allowed in SIWE messages for wallet sign-in (EIP-4361).
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `api_key` string, required: The platform API key. Save immediately - it cannot be retrieved again.

## Other responses

- `400`: Invalid request
- `403`: Only human users can register platform apps

---

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