Get GitHub Organizations

Retrieve all GitHub organizations associated with the authenticated user’s account.

GET https://cloud.blackbox.ai/api/github/orgs

cURL

curl --location 'https://cloud.blackbox.ai/api/github/orgs' \
--header 'Authorization: Bearer bb_YOUR_API_KEY'

Success Response

[
    {
        "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"
    }
]

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

curl --location 'https://cloud.blackbox.ai/api/github/orgs' \
--header 'Authorization: Bearer bb_YOUR_API_KEY'

Success Response

[
    {
        "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 Code	Error	Description
200	Success	Organizations retrieved successfully
401	Unauthorized	Invalid or missing API key
404	Not Found	GitHub token not found or expired
502	Bad Gateway	GitHub API error occurred
500	Internal Server Error	Database or server error occurred