Admin

Create or fully replace a program

Same shape as seed files. Replaces the program's milestones, specs, technical blocks and catalysts. ?onlyNew=1 (routines that add programs): 409 and nothing written when the company already has a program with this slug.

put/v1/admin/programs

Request

Base URL: http://api.technooptimist.io
URL: http://api.technooptimist.io/v1/admin/programs
Auth: HTTP bearer

Query parameters

onlyNew'1' | 'true'

Create only: 409 if it already exists

Headers

x-routine-namestring

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

Example:news-scan

Request body

companystring required

Response

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.