GitBowl REST API v1

v1.0.0

Standard GitHub-compatible REST API. Supports Personal Access Tokens (PATs) and rate limits of 5,000 req/hr for authenticated requests.

Authentication

Authorization: Bearer gbp_...

Pass Personal Access Tokens with the prefix gbp_.

Rate Limits

5,000 / hr (Auth) · 60 / hr (Anon)

Tracked via X-RateLimit-Remaining and reset headers.

GitHub Compatibility

Drop-in compatible schemas

Use with existing Octokit scripts or standard GitHub API SDKs.

GET/api/v1/user
Auth Required
5,000 / hour

Returns profile information for the user authenticated by the bearer token.

curl -H "Authorization: Bearer gbp_your_pat" https://gitbowl.dev/api/v1/user
GET/api/v1/user/repos
Auth Required
5,000 / hour

List repositories that the authenticated user owns.

curl -H "Authorization: Bearer gbp_your_pat" https://gitbowl.dev/api/v1/user/repos
POST/api/v1/user/repos
Auth Required
5,000 / hour

Create a new repository for the authenticated user.

curl -X POST -H "Authorization: Bearer gbp_your_pat" -H "Content-Type: application/json" -d '{"name":"my-project","private":false}' https://gitbowl.dev/api/v1/user/repos
GET/api/v1/repos/{owner}/{repo}
60 / hr (unauth) | 5,000 / hr (auth)

Retrieve metadata for a repository.

curl https://gitbowl.dev/api/v1/repos/octocat/hello-world
GET/api/v1/repos/{owner}/{repo}/commits
60 / hr (unauth) | 5,000 / hr (auth)

List commit history for a repository in reverse chronological order.

curl https://gitbowl.dev/api/v1/repos/octocat/hello-world/commits
GET/api/v1/repos/{owner}/{repo}/branches
60 / hr (unauth) | 5,000 / hr (auth)

List all branches with their head commit SHAs.

curl https://gitbowl.dev/api/v1/repos/octocat/hello-world/branches
GET/api/v1/repos/{owner}/{repo}/contents/{path}
60 / hr (unauth) | 5,000 / hr (auth)

Fetch file contents base64-encoded or list directory items.

curl https://gitbowl.dev/api/v1/repos/octocat/hello-world/contents/README.md
PUT/api/v1/repos/{owner}/{repo}/contents/{path}
Auth Required
5,000 / hour

Creates or updates a file in the repository and generates a commit.

curl -X PUT -H "Authorization: Bearer gbp_your_pat" -H "Content-Type: application/json" -d '{"message":"Update README","content":"SGVsbG8gV29ybGQh"}' https://gitbowl.dev/api/v1/repos/octocat/hello-world/contents/README.md
GET/api/v1/repos/{owner}/{repo}/pulls
60 / hr (unauth) | 5,000 / hr (auth)

List pull requests for a repository.

curl https://gitbowl.dev/api/v1/repos/octocat/hello-world/pulls?state=open
POST/api/v1/repos/{owner}/{repo}/pulls
Auth Required
5,000 / hour

Create a new pull request between branches.

curl -X POST -H "Authorization: Bearer gbp_your_pat" -H "Content-Type: application/json" -d '{"title":"Feature A","head":"feature-a","base":"main"}' https://gitbowl.dev/api/v1/repos/octocat/hello-world/pulls