---
title: "Current process identity and launch readiness"
method: GET
path: "/v1/diagnostics/launch"
tags: ["System"]
---

# Current process identity and launch readiness

`GET /v1/diagnostics/launch`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/diagnostics/launch`
- Auth: HTTP bearer

Read-only, free at every tier. Requires tools:read for authenticated remote callers. Reports the process provenance, effective license state, listener and admission ownership, audit readiness and launch journal state. Optional identity evidence is omitted when unavailable.

## Response `200`

Current launch diagnostic snapshot

- LaunchDiagnostics
  - `identity` LaunchProcessIdentity, required
    - `instanceId` string, required
    - `requestId` string
    - `predecessorId` string
    - `pid` number, required
    - `processStartedAt` string
    - `executableDigest` string
    - `sourceDigest` string
    - `sourceRevision` string
    - `sourceDirty` boolean
    - `sourceStable` boolean
    - `configuration` string, required
  - `license` LaunchLicenseDiagnostics, required
    - `effectiveTier` string, required
    - `source` 'none' | 'serverConfirmed' | 'cachedPayload' | 'localOverride' | 'heldGrant', required
    - `accountState` 'resolving' | 'entitled' | 'degraded' | 'expired' | 'notEntitled', required
    - `reason` 'processStarted' | 'resolving' | 'serverConfirmed' | 'cachedPayload' | 'localOverride' | 'keychainUnreadable' | 'keychainUnwritable' | 'payloadUnverifiable' | 'serverUnreachable' | 'expired' | 'neverSignedIn' | 'signedOut' | 'fingerprintMismatch' | 'startInProgress' | 'startCompleted' | 'startErrored', required
    - `lifecycle` 'notStarted' | 'inProgress' | 'completed' | 'errored', required
    - `entitlementReady` boolean, required
    - `accountAuthoritative` boolean, required
    - `overrideRequest` 'absent' | 'valid' | 'invalid' | 'retired' | 'releaseRejected', required
    - `requestedTier` string
    - `overrideApplied` boolean, required
    - `mode` 'normal' | 'development', required
    - `overrideImmutable` boolean, required
    - `developmentValidUntil` string
  - `listenerReady` boolean, required
  - `admissionHeld` boolean, required
  - `auditReady` boolean, required
  - `auditWriterAttributed` boolean, required
  - `auditReason` string
  - `journalStatus` 'ready' | 'unavailable', required
  - `lastTransitionReason` 'processStarted' | 'resolving' | 'serverConfirmed' | 'cachedPayload' | 'localOverride' | 'keychainUnreadable' | 'keychainUnwritable' | 'payloadUnverifiable' | 'serverUnreachable' | 'expired' | 'neverSignedIn' | 'signedOut' | 'fingerprintMismatch' | 'startInProgress' | 'startCompleted' | 'startErrored', required
  - `lastTransitionAt` string, required

## Other responses

- `401`: Authentication required
- `403`: Missing tools:read scope
- `503`: Launch identity unavailable

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)