repos

Mint a short-lived git remote for a plain repo (Kody smart-HTTP proxy in front of Cloudflare Artifacts).

Mint a short-lived git remote for a plain repo (Kody smart-HTTP proxy in front of Cloudflare Artifacts). When scope is omitted, defaults to write if you have org-wide write access, otherwise read. Pass scope explicitly to force read or write; requesting write without write access is denied with guidance (use scope: 'read', or ask an Owner for a grant). Write pushes are live at HEAD — no package publish reconcile step runs afterward. Concurrent push lock contention is held and retried on the proxy (bounded wait) before HTTP 503 with Retry-After and "repository busy, retry". A read remote rejects push with: this remote is read-only; request scope: 'write'. The result includes git_author (signed-in Kody account email and display name) and setup_commands that set local user.email / user.name to that identity — never invent a git email. The Artifacts backing store fails pushes above ~32 MiB of decompressed pack content with a raw HTTP 413.

Org permission: package:read.

post/v1/repos/git-remote

Request

  • Base URL: https://api.kody.codes
  • URL: https://api.kody.codes/v1/repos/git-remote
  • Auth: HTTP bearer

Request body

repo_idstring

Plain repo UUID, or the repo name. OpenAPI path /v1/repos/{repo_id}/git-remote accepts either. Prefer name (or this field) on POST /v1/repos/git-remote when calling via CLI/OpenAPI without a path id.

namestring

Plain repo name. Provide exactly one of repo_id or name. Works on MCP api, execute, and OpenAPI POST /v1/repos/git-remote.

scope'read' | 'write'

Access scope for the minted Artifacts token. When omitted, defaults to write if you have write access, otherwise read. Explicit scope is honored; requesting write without write access is denied. A read remote rejects push with: this remote is read-only; request scope: 'write'.

ttl_secondsinteger

Response

Success.

repo_idstring required
namestring required
source_idstring required
remotestring required
authenticated_remotestring required
git_extra_headerstring required
scope'read' | 'write' required
expires_atstring required
setup_commandsstring[] required
live_at_headtrue required

Changes

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