Admin

Patch a program's live state

Only provided fields change (name renames the program; its slug and URL stay). A stage/statusLine change emits program.changed.

patch/v1/admin/programs/{company}/{program}

Request

  • Base URL: http://api.technooptimist.io
  • URL: http://api.technooptimist.io/v1/admin/programs/{company}/{program}
  • Auth: HTTP bearer

Path parameters

companystring required
Example:helion
programstring required
Example:polaris

Headers

x-routine-namestring

Name of the routine making the write; recorded as routine:<name> in the audit log.

Example:news-scan

Request body

namestring
stage'research' | 'proto' | 'pilot' | 'deploy' | 'scaling'
statusLinestring
descriptionstring
goalstring
keywordsstring
imageUrlstring uri nullable

Response

Updated program page

oktrue required

Example response

{
  "program": {
    "company": {
      "slug": "helion",
      "checkedAt": "2025-07-30T12:00:00.000Z"
    },
    "program": {
      "slug": "helion",
      "frontier": {
        "slug": "helion"
      },
      "field": {
        "slug": "helion"
      },
      "lastUpdateAt": "2025-07-30T12:00:00.000Z",
      "path": "/robotics/figure-03",
      "checkedAt": "2025-07-30T12:00:00.000Z"
    },
    "milestones": [
      {
        "date": {
          "date": "2025-07-01"
        },
        "originalTarget": {
          "date": "2025-07-01"
        }
      }
    ],
    "important": {
      "items": [
        {
          "occurredAt": "2025-07-30T12:00:00.000Z",
          "company": {
            "slug": "helion"
          },
          "program": {
            "slug": "helion",
            "frontier": "helion",
            "path": "/robotics/figure-03"
          },
          "frontiers": [
            "helion"
          ],
          "createdAt": "2025-07-30T12:00:00.000Z"
        }
      ]
    },
    "events": {
      "upcoming": [
        {
          "date": {
            "date": "2025-07-01"
          },
          "originalTarget": {
            "date": "2025-07-01"
          }
        }
      ],
      "past": [
        {
          "date": {
            "date": "2025-07-01"
          },
          "originalTarget": {
            "date": "2025-07-01"
          }
        }
      ]
    },
    "catalysts": [
      {
        "date": "2025-07-01"
      }
    ],
    "research": [
      {
        "date": "2025-07-01"
      }
    ],
    "siblings": [
      {
        "slug": "helion",
        "frontier": "helion",
        "path": "/robotics/figure-03"
      }
    ],
    "peers": [
      {
        "company": {
          "slug": "helion"
        },
        "slug": "helion",
        "path": "/robotics/figure-03"
      }
    ]
  }
}

Changes

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