harbor

Remote Rollouts

API Overview

Base URL, authentication, and error shapes for the remote rollout API

The launch functionality available through the Web UI and CLI is largely available through an API.

The base URL for all endpoints is:

https://ofhuhcpkvzjlejydnvyd.supabase.co/functions/v1

Authentication

Every request needs a Harbor API key sent as a bearer token. See Harbor Hub API Key for how to create one.

Authorization: Bearer sk-harbor-...
Content-Type: application/json

Errors

All errors share one shape:

{
  "error": {
    "code": "validation_failed",
    "message": "config must contain at least one agent"
  }
}
CodeStatusMeaning
bad_request400Malformed request, or a missing/oversized Idempotency-Key
validation_failed400The body parsed but broke a schema or server-side rule
unauthorized401Missing or invalid API key
forbidden403Not approved for remote rollouts, or not a member of the chosen organization
not_found404The job does not exist or is not visible to you
method_not_allowed405HTTP method not supported on that path
replacement_required409A credential with this identity already exists; confirm the replacement
replacement_stale409The credential changed while you were confirming; re-read and retry
quota_exceeded429You are over your hosted quota
server_error500Internal failure
agent_version_resolution_failed503Could not resolve the latest agent version; retry

On this page