harbor-api
Installation
SKILL.md
Harbor REST API v2
Base: /api/v2.0. Latest stable: Harbor v2.15.1 (May 2026). API spec: Swagger 2.0 at api/v2.0/swagger.yaml. Built-in Swagger UI: https://<harbor>/devcenter-api-2.0.
Authentication
| Method | Header / Usage | Use Case |
|---|---|---|
| Basic Auth | -u username:password |
Direct admin/developer API access |
| Bearer Token | Authorization: Bearer <token> |
Obtained from /service/token per Docker Registry v2 spec |
| Robot Account | -u robot$<prefix><name>:<secret> |
Automated CI/CD with scoped permissions |
| OIDC ID Token | Authorization: Bearer <oidc_id_token> |
OIDC-authenticated users (basic auth not supported for OIDC) |
Bearer Token Flow
# Get token for push/pull access to a repo
TOKEN=$(curl -s -u "username:password" \
"https://harbor.example.com/service/token?service=harbor-registry&scope=repository:project/repo:pull,push" \
| jq -r '.token')