---
title: "Update platform app"
method: PATCH
path: "/v1/platform/apps/{appId}"
tags: ["Platform"]
---

# Update platform app

`PATCH /v1/platform/apps/{appId}`

## Request

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

## Path parameters

- `appId` string, uuid, required

## Request body

- UpdatePlatformAppRequest
  - `name` string
  - `description` string
  - `logo_url` string
  - `oidc_jwks_url` string
  - `oidc_issuer` string
  - `oidc_audience` string: Expected audience claim for OIDC token validation
  - `redirect_uris` string[]
  - `webhook_url` string
  - `billing_model` 'platform_pays' | 'user_pays' | 'hybrid'
  - `auth_mode` 'silent' | 'user_signin' | 'configurable'
  - `max_connected_users` integer, nullable
  - `max_agents_per_connection` integer, nullable: Agents one connection may hold, enforced by `POST /v1/platform/connections/{connectionId}/agents`. `null` clears the override back to the built-in default; it does not mean unlimited.
  - `is_active` boolean
  - `api_key_expires_at` string, date-time, nullable: Optional expiration time for the platform API key. Set to null to clear.
  - `siwe_domain` string, nullable: Hostname allowed in SIWE messages for wallet sign-in (EIP-4361).

## Response `200`

Updated platform app

- PlatformAppResponse
  - `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](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/5fa0918f3b41?raw)