Beta module namespace
gitpublish
Beta routes may change with notice and are NOT covered by the 24-month stable window of the core contract.
Every module route is enumerated with method, path, auth and required permission; request/response schemas are not published for the beta surface.
13 operations
| Method | Path | Required permission | Authentication | Summary |
|---|---|---|---|---|
| get | /v1/m/gitpublish/intents | gitpublish:target:read | Bearer token | Lists the publication intents of one target, named by ?target_id, with what each requested, what the host was last observed to hold and its current state. |
| get | /v1/m/gitpublish/intents/{id} | gitpublish:target:read | Bearer token | Returns one publication intent: what it requested, what the host was last observed to hold, whether the host acknowledged the request, and its state. |
| post | /v1/m/gitpublish/intents/{id}/abandon | gitpublish:target:admin | Bearer token | Records that an administrator takes responsibility for an unresolved publication intent, with a bounded reason. |
| get | /v1/m/gitpublish/intents/{id}/observations | gitpublish:target:read | Bearer token | Lists every observation recorded for one publication intent: each host read, dispatcher outcome and refusal, with its attempt, result and time. |
| post | /v1/m/gitpublish/intents/{id}/reconcile | gitpublish:target:read | Bearer token | Reads the host again for one publication intent and records what it observed. |
| get | /v1/m/gitpublish/targets | gitpublish:target:read | Bearer token | Lists the publication targets the caller can read, without their credential and repository binding ids. |
| post | /v1/m/gitpublish/targets | gitpublish:target:admin | Bearer token | Records a publication target in a workspace: an approved credential binding, an approved repository binding, the branch prefix pushes must stay under and the allowed merge bases. |
| get | /v1/m/gitpublish/targets/{id} | gitpublish:target:read | Bearer token | Returns one publication target. |
| put | /v1/m/gitpublish/targets/{id} | gitpublish:target:admin | Bearer token | Replaces a publication target's bindings, push prefix and merge bases under optimistic concurrency, refusing a stale expected_version. |
| delete | /v1/m/gitpublish/targets/{id} | gitpublish:target:admin | Bearer token | Deletes a publication target that no dispatching, uncertain or abandoned intent still holds. |
| post | /v1/m/gitpublish/targets/{id}/merges | gitpublish:merge:admin | Bearer token | gitpublish module route (requires gitpublish:merge:admin) |
| post | /v1/m/gitpublish/targets/{id}/pull-requests | gitpublish:pull_request:write | Bearer token | gitpublish module route (requires gitpublish:pull_request:write) |
| post | /v1/m/gitpublish/targets/{id}/pushes | gitpublish:push:write | Bearer token | gitpublish module route (requires gitpublish:push:write) |