Platform

Register a platform app

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

post/v1/platform/apps

Request

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

Request body

namestring required
slugstring required
descriptionstring
oidc_jwks_urlstring uri
oidc_issuerstring uri
oidc_audiencestring

Expected audience claim for OIDC token validation

redirect_urisstring[]
billing_model'platform_pays' | 'user_pays' | 'hybrid'
auth_mode'silent' | 'user_signin' | 'configurable'
max_connected_usersinteger nullable
api_key_expires_atstring date-time nullable

Optional expiration time for the platform API key.

Response

Platform app created

idstring uuid
namestring
slugstring
descriptionstring
logo_urlstring nullable
api_key_prefixstring
oidc_jwks_urlstring nullable
oidc_issuerstring nullable
oidc_audiencestring nullable

Expected audience claim for OIDC token validation

redirect_urisstring[]
webhook_urlstring nullable
is_activeboolean
billing_modelstring
auth_modestring
max_connected_usersinteger nullable
connected_usersinteger
api_key_expires_atstring date-time nullable

When the platform API key expires.

api_key_rotated_atstring date-time nullable

When the platform API key was last rotated.

siwe_domainstring nullable

Hostname allowed in SIWE messages for wallet sign-in (EIP-4361).

created_atstring date-time
updated_atstring date-time
api_keystring required

The platform API key. Save immediately - it cannot be retrieved again.

Changes

No recorded changes to this operation across all 1 revision of this API.