Skip to main content
GET
/
api
/
github
/
orgs
curl --location 'https://cloud.blackbox.ai/api/github/orgs' \
--header 'Authorization: Bearer YOUR_API_KEY'

[
    {
        "login": "example-org",
        "name": "Example Organization",
        "avatar_url": "https://avatars.githubusercontent.com/u/12345678?v=4"
    },
    {
        "login": "another-org",
        "name": "Another Organization",
        "avatar_url": "https://avatars.githubusercontent.com/u/87654321?v=4"
    }
]

Documentation Index

Fetch the complete documentation index at: https://docs.blackbox.ai/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint returns a list of all GitHub organizations that the authenticated user has access to, including organization details such as name, login, and avatar.

​
Authentication

To use this API, you need a BLACKBOX API Key. Follow these steps to get your API key:
  1. Click on your Profile Image in the top right corner at cloud.blackbox.ai
  2. Click on “BLACKBOX API Token” from the dropdown menu
  3. Copy the existing token or click “Generate” if you don’t have one yet
Your API key will be in the format: bb_xxxxxxxxxxxxxxxxxxxxxx

​
Headers

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

​
Response

The endpoint returns an array of organization objects.
​
login
string
The organization’s GitHub username/login identifier.
​
name
string
The display name of the organization.
​
avatar_url
string
URL to the organization’s avatar image.
curl --location 'https://cloud.blackbox.ai/api/github/orgs' \
--header 'Authorization: Bearer YOUR_API_KEY'

[
    {
        "login": "example-org",
        "name": "Example Organization",
        "avatar_url": "https://avatars.githubusercontent.com/u/12345678?v=4"
    },
    {
        "login": "another-org",
        "name": "Another Organization",
        "avatar_url": "https://avatars.githubusercontent.com/u/87654321?v=4"
    }
]

​
Error Codes

Status CodeErrorDescription
200SuccessOrganizations retrieved successfully
401UnauthorizedInvalid or missing API key
404Not FoundGitHub token not found or expired
502Bad GatewayGitHub API error occurred
500Internal Server ErrorDatabase or server error occurred