Skip to main content
GET
/
api
/
v1
/
git
/
config
curl 'https://agent.blackbox.ai/api/v1/git/config' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "connected": true,
  "login": "octocat",
  "name": "The Octocat",
  "email": "octocat@github.com",
  "avatarUrl": "https://avatars.githubusercontent.com/u/583231",
  "scopes": "repo,user",
  "tokenCreatedAt": "2026-05-01T12:00:00.000Z"
}
This endpoint returns the GitHub account connected to your BLACKBOX API key. Use it to check which GitHub user is linked before creating tasks that work with repositories.
This endpoint requires a Pro subscription.

​
Authentication

To use this API, you need a BLACKBOX API Key. Follow these steps to get your API key:
  1. Go to app.blackbox.ai/agent-api and click Get an API Key (requires a Pro subscription)
  2. Once provisioning completes, you will be redirected to your Dashboard
  3. From the Dashboard, create an API key to use with all Agent API requests
Your API key will be in the format: sk-xxxxxxxxxxxxxxxxxxxxxx

​
Headers

​
Authorization
string
required
API Key of the form Bearer <api_key>.Example: Bearer sk_b41b647ffbfed27f616560

​
Response Fields

​
connected
boolean
true if a valid GitHub token is stored, false otherwise.
​
login
string
GitHub username. Present when connected: true.
​
name
string | null
Display name of the GitHub user.
​
email
string | null
Primary email of the GitHub user.
​
avatarUrl
string
GitHub avatar URL.
​
scopes
string
OAuth scopes granted by the token (e.g. "repo,user").
​
tokenCreatedAt
string | null
ISO 8601 timestamp when the token was stored. null if not recorded.
curl 'https://agent.blackbox.ai/api/v1/git/config' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "connected": true,
  "login": "octocat",
  "name": "The Octocat",
  "email": "octocat@github.com",
  "avatarUrl": "https://avatars.githubusercontent.com/u/583231",
  "scopes": "repo,user",
  "tokenCreatedAt": "2026-05-01T12:00:00.000Z"
}

​
Error Codes

Status CodeErrorDescription
200SuccessConfig returned
401UnauthorizedInvalid or missing API key
403ForbiddenPro subscription required
500Internal Server ErrorFailed to retrieve config