---
title: "Record an automated governance run result."
method: POST
path: "/api/admin/governance/runs"
---

# Record an automated governance run result.

`POST /api/admin/governance/runs`

## Request

- Base URL: `https://git.top`
- URL: `https://git.top/api/admin/governance/runs`
- Auth: HTTP bearer

## Request body

- GovernanceRunInput
  - `id` string
  - `task` string, required: Short governance task identifier.
  - `status` 'success' | 'failed' | 'running' | 'skipped', required
  - `trigger` 'github_actions' | 'cron' | 'admin' | 'manual'
  - `started_at` string, date-time
  - `finished_at` string, date-time
  - `duration_ms` integer
  - `summary` object
  - `report_url` string
  - `error` string

## Response `200`

Persisted governance run

## Other responses

- `400`: Invalid governance run payload
- `401`: Missing or invalid admin authorization

---

[API](https://skmtc.dev/git/apis/git-top-agent-api.md) · [All operations](https://skmtc.dev/git/apis/git-top-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/git/apis/git-top-agent-api/revisions/c9ebf661ef6d?raw)