API overview
Base URL: https://api.amendable.io
Interactive OpenAPI: https://api.amendable.io/docs
Machine OpenAPI: https://api.amendable.io/openapi.json
Auth: header access-token. JSON in, JSON out. Create often returns 201. Delete returns 204 with an empty body.
Git is not on the API host. Git is https://amendable.io/r/.... Staging hosts: Environments.
Endpoints
Section titled “Endpoints”| Method | Path | Grant |
|---|---|---|
| POST | /v1/auth/sessions | none |
| GET | /v1/auth/sessions/{id}/poll | none (secret query param) |
| GET | /v1/account/usage | any token |
| GET | /v1/repositories | any token |
| POST | /v1/repositories | API_REPOS_WRITE |
| GET | /v1/repos/{user}/{name} | any token that can see it |
| DELETE | /v1/repos/{user}/{name} | API_REPOS_WRITE |
| GET | /v1/repos/{user}/{name}/branches | API_COMMITS_READ |
| GET | /v1/repos/{user}/{name}/commits | API_COMMITS_READ |
| GET/POST | /v1/access-tokens | ALL + ALL_REPO |
| GET/PUT/DELETE | /v1/access-tokens/{id} | ALL + ALL_REPO |
| GET/POST | /v1/webhooks | API_WEBHOOKS |
| GET/DELETE | /v1/webhooks/{id} | API_WEBHOOKS |
| POST | /v1/webhooks/{id}/ping | API_WEBHOOKS |
| GET | /v1/webhooks/{id}/deliveries | API_WEBHOOKS |
| GET/POST | /v1/storage-buckets | API_STORAGE |
| GET | /v1/storage-buckets/oidc-setup | API_STORAGE |
| GET | /v1/storage-buckets/errors | API_STORAGE |
| PUT/DELETE | /v1/storage-buckets/{id} | API_STORAGE |
| POST | /v1/storage-buckets/{id}/verify | API_STORAGE |
| POST | /v1/oidc/token | none (ID token in body) |
| GET | /v1/oidc-trust-rules/setup | API_OIDC_TRUST + ALL_REPO |
| GET/POST | /v1/oidc-trust-rules | API_OIDC_TRUST + ALL_REPO |
| GET/PUT/DELETE | /v1/oidc-trust-rules/{id} | API_OIDC_TRUST + ALL_REPO |
ALL satisfies any grant. Device-login session routes are omitted from the public OpenAPI schema (include_in_schema=False) but they work. The CLI uses them.
Errors: Errors.