Workspace ID lookup
GET /api/v1/workspacesReturns the workspaces owned by the API key’s account. Use an ID from this response when starting a search. The endpoint does not create workspaces or return other users’ workspaces.
Request
Section titled “Request”curl --fail-with-body \ 'https://githoundexplore.com/api/v1/workspaces' \ -H "Authorization: Bearer $GITHOUND_API_KEY"| Parameter | Location | Required | Description |
|---|---|---|---|
cursor | Query | No | Opaque next_cursor from the preceding response. |
Do not send a limit, page, or other query parameter. The server returns up to 100 workspaces per page.
Response
Section titled “Response”200 OK · application/json
Illustrative response:
{ "workspaces": [ { "id": "123e4567-e89b-42d3-a456-426614174000", "name": "Exposure review" } ], "next_cursor": null}| Field | Type | Meaning |
|---|---|---|
workspaces | array | Zero to 100 owned workspaces. |
workspaces[].id | UUID string | Identifier for the search endpoint. |
workspaces[].name | string | Workspace display name, up to 200 characters. |
next_cursor | string or null | Pass unchanged to retrieve the next page; null means the final page. |
An empty workspaces array is a successful response. Create a workspace in the GitHound application if you do not yet have one.
Pagination
Section titled “Pagination”curl --fail-with-body --get \ 'https://githoundexplore.com/api/v1/workspaces' \ -H "Authorization: Bearer $GITHOUND_API_KEY" \ --data-urlencode "cursor=$NEXT_CURSOR"Treat cursors as opaque. They are account-bound and expire after 24 hours. If a cursor expires or becomes invalid, restart from the first page. Do not decode, modify, share across accounts, or persist cursors as permanent workspace identifiers.
The server orders pages by workspace creation time and identifier. Pagination is not a snapshot: concurrent workspace changes can affect what is available while you paginate.
Errors and limits
Section titled “Errors and limits”400 invalid_cursor means the cursor is malformed, expired, or belongs to another account. Authentication and eligibility errors are described in Errors.
Workspace lists are limited to 60 requests per minute per account, shared by all keys. They do not consume a code-search daily allowance. A separate per-IP ingress limit also applies.