Owner-only metadata + storage key inventory

Returns the resolved app envelope (manifest, capabilities, revision), whether ui/styles are present, the persisted storage keys, and a machine-readable API summary so an agent can plan calls without reading the module source. Use a fresh GET /app/{id}/source response or ETag for write preconditions; a cached descriptor revision is informational.

get/app/{id}/describe

Request

  • Base URL: https://charm.ing
  • URL: https://charm.ing/app/{id}/describe
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Response

Metadata

idstring uuid required
manifestIdstring required
displayNamestring required
revisioninteger required

Server-owned app source revision. New apps start at 1, each successful source write advances it once, and historical null counters project as 0. If-Match: "<N>" and expected_revision carry this revision through its canonical concurrency grammar.

capabilitiesCapabilities required(unresolved $ref)
uiboolean required
stylesboolean required
claimedboolean required
expiresAtstring date-time nullable required
storageKeysstring[] required

Changes

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