Apps

Get app details

get/apps/{appRef}

Request

  • Base URL: https://api.percher.run
  • URL: https://api.percher.run/apps/{appRef}
  • Auth: HTTP bearer

Path parameters

appRefstring required

Response

App details. Carries the caller's effective access ('owner' | 'admin' | 'viewer') so dashboards can render role-aware UI without a second roundtrip.

idstring
namestring
runtimestring
frameworkstring nullable
status'provisioning' | 'live' | 'crashed' | 'suspended'
urlstring uri
dataMode'none' | 'pocketbase' | 'postgres' | 'sqlite' | 'convex' | 'supabase' | 'external'
createdAtstring date-time
access'owner' | 'admin' | 'viewer'

Caller's effective role. 'admin' grants the operational write surface (deploy, env, domains, KV, logs, PocketBase ops); 'viewer' is read-only; 'owner' is everything including delete / transfer / rename / share management.

Changes

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