---
title: "Inspect a Program"
method: GET
path: "/v1/programs/{configObjectId}"
tags: ["Codemode Runs"]
---

# Inspect a Program

`GET /v1/programs/{configObjectId}`

## Path parameters

- `configObjectId` string, required

## Response `200`

Program returned.

- object
  - `program` object, required
    - `type` 'program', required
    - `id` string, required
    - `plugin` object, nullable, required
      - `id` string, required
      - `name` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `role` 'viewer' | 'editor' | 'manager', required
    - `edges` unknown[], required
      - unknown
    - `state` 'ready' | 'needs_signin' | 'needs_admin_setup', required
    - `resultState` 'never_run' | 'fresh' | 'stale' | 'needs_attention', required
    - `latestSuccessfulAt` string, date-time, nullable, required
    - `viewState` 'default' | 'custom_active' | 'build_failed' | 'retired', required
    - `activeViewTitle` string, nullable, required
    - `automationCount` integer, required
    - `source` object, required
      - `kind` 'created' | 'installed_template', required
      - `templateName` string
      - `templateVersion` string
  - `script` object, required
    - `pluginId` string, required
    - `configObjectId` string, required
    - `title` string, required
    - `description` string, nullable, required
    - `canRun` boolean, required
    - `canManage` boolean, required
    - `currentVersion` object, required
      - `id` string, required
      - `code` string, nullable, required
      - `inputSchema` unknown, required
      - `outputSchema` unknown, required
      - `exampleInput` unknown
      - `requiredCapabilities` object[], required
        - `capabilityName` string, required
        - `scriptPath` string, required
      - `codeDigest` string, required
      - `inputSchemaDigest` string, nullable, required
      - `outputSchemaDigest` string, nullable, required
      - `createdAt` string, date-time, required
      - `automationReferences` object[], required
        - `id` string, required
        - `name` string, required
        - `state` 'active' | 'inactive' | 'needs_attention' | 'archived', required
        - `configObjectVersionId` string, required
        - `input` unknown
    - `versions` object[], required
      - `id` string, required
      - `code` string, nullable, required
      - `inputSchema` unknown, required
      - `outputSchema` unknown, required
      - `exampleInput` unknown
      - `requiredCapabilities` object[], required
        - `capabilityName` string, required
        - `scriptPath` string, required
      - `codeDigest` string, required
      - `inputSchemaDigest` string, nullable, required
      - `outputSchemaDigest` string, nullable, required
      - `createdAt` string, date-time, required
      - `automationReferences` object[], required
        - `id` string, required
        - `name` string, required
        - `state` 'active' | 'inactive' | 'needs_attention' | 'archived', required
        - `configObjectVersionId` string, required
        - `input` unknown
    - `latestSnapshot` object, nullable, required
      - `receiptId` string, required
      - `pluginId` string, required
      - `configObjectId` string, required
      - `configObjectVersionId` string, required
      - `automationRunId` string, nullable, required
      - `value` unknown, required
      - `markdown` string, nullable, required
      - `codeDigest` string, required
      - `resultDigest` string, nullable, required
      - `inputSchemaDigest` string, nullable, required
      - `outputSchemaDigest` string, nullable, required
      - `rendererVersion` 'codemode-markdown-v1', nullable, required
      - `status` 'succeeded' | 'failed', required
      - `errorKind` string, nullable, required
      - `errorMessage` string, nullable, required
      - `source` 'manual' | 'scheduled', required
      - `startedAt` string, date-time, required
      - `finishedAt` string, date-time, required
      - `contentDeletedAt` string, date-time, nullable, required
    - `latestSuccessfulSnapshot` object, nullable, required
      - `receiptId` string, required
      - `pluginId` string, required
      - `configObjectId` string, required
      - `configObjectVersionId` string, required
      - `automationRunId` string, nullable, required
      - `value` unknown, required
      - `markdown` string, nullable, required
      - `codeDigest` string, required
      - `resultDigest` string, nullable, required
      - `inputSchemaDigest` string, nullable, required
      - `outputSchemaDigest` string, nullable, required
      - `rendererVersion` 'codemode-markdown-v1', nullable, required
      - `status` 'succeeded' | 'failed', required
      - `errorKind` string, nullable, required
      - `errorMessage` string, nullable, required
      - `source` 'manual' | 'scheduled', required
      - `startedAt` string, date-time, required
      - `finishedAt` string, date-time, required
      - `contentDeletedAt` string, date-time, nullable, required
    - `freshness` union, required
      - object
        - `state` 'never_run', required
      - object
        - `state` 'fresh', required
        - `ageMs` integer, required
      - object
        - `state` 'stale', required
        - `ageMs` integer, required
        - `maxAgeMs` integer, required
      - object
        - `state` 'needs_attention', required
        - `ageMs` integer, nullable, required
        - `lastSuccessfulReceiptId` string, nullable, required
        - `reason` string, required
  - `views` object[], required
    - `id` string, required
    - `configObjectId` string, required
    - `title` string, required
    - `description` string, nullable, required
    - `status` 'active' | 'retired', required
    - `activeRevisionId` string, nullable, required
    - `revisions` object[], required
      - `id` string, required
      - `artifactViewId` string, required
      - `resourceUri` string, required
      - `buildStatus` 'ready' | 'failed', required
      - `sourceDigest` string, required
      - `resourceDigest` string, nullable, required
      - `outputSchemaDigest` string, required
      - `csp` object, required
        - `connectDomains` string[], required
        - `resourceDomains` string[], required
        - `frameDomains` string[], required
        - `baseUriDomains` string[], required
      - `diagnostics` object[], required
        - `level` 'error' | 'warning', required
        - `message` string, required
        - `line` integer, nullable, required
        - `column` integer, nullable, required
      - `compilerName` string, required
      - `compilerVersion` string, required
      - `reactVersion` string, required
      - `compiledHtmlBytes` integer, nullable, required
      - `retiredAt` string, date-time, nullable, required
      - `createdAt` string, date-time, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `404` — Program not found.

---

[API](https://skmtc.net/openworklabs/apis/den-api.md) · [All operations](https://skmtc.net/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openworklabs/den-api/revisions/6915dfb03e5d/schema)