Repositories

Discover repositories available through connected installations

Lists repositories available through the authenticated organization’s GitHub, GitLab, Bitbucket and Azure Repos connections, including repositories not yet added as assets. Requires assets:read and an organization-wide token; asset-scoped tokens receive 403. Uses the same discovery logic and response as the dashboard. GitHub search is a case-insensitive full_name substring match, sorted by full_name, over a process-local inventory cached for two minutes and capped at 100 pages of 100 repositories per installation. Search pagination is applied per installation/provider, so a combined page can exceed per_page. An empty search uses direct provider pagination. refresh=1 with search reloads GitHub inventory (concurrent refreshes share the refresh walk); without search it invalidates GitHub inventory and returns only the normal direct page. The next search reloads. GitHub access-change webhooks invalidate inventory on the receiving instance; other instances expire within the TTL. Provider failures may return partial or empty results; Azure failures include a warning.

GET

/

repositories

/

discovery

Error

A valid request URL is required to generate request examples

{
  "repos": [
    {
      "id": "<string>",
      "full_name": "<string>",
      "private": true,
      "default_branch": "<string>",
      "provider": "github",
      "installation_id": 123,
      "archived": true
    }
  ],
  "hasMore": true,
  "hasIntegrations": true,
  "warning": "<string>",
  "githubSelectedAccess": [
    {
      "installation_id": 123,
      "account_login": "<string>",
      "manage_url": "<string>"
    }
  ]
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

Authorizations

Authorization

string

header

required

API token obtained from the Tokens endpoint or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.

Scopes

assets:read

Query Parameters

search

string

Repository name filter. Whitespace is trimmed.

page

integer

default:1

Required range: x >= 1

per_page

integer

default:25

Results per installation/provider. Values above 25 are capped.

Required range: 1 <= x <= 25

refresh

enum<string>

Bypass cached GitHub search inventory, or invalidate it without walking when search is empty.

Available options:

1

azure_installation_id

integer

Limit discovery to this Azure Repos connection belonging to the authenticated organization.

Response

Available installation repositories. Does not add repository assets.

repos

object[]

required

Show child attributes

hasMore

boolean

required

At least one source has more results.

hasIntegrations

boolean

required

warning

string

githubSelectedAccess

object[]

Optional first-page unfiltered hints for GitHub installations restricted to selected repositories.

Show child attributes

Error

A valid request URL is required to generate request examples

{
  "repos": [
    {
      "id": "<string>",
      "full_name": "<string>",
      "private": true,
      "default_branch": "<string>",
      "provider": "github",
      "installation_id": 123,
      "archived": true
    }
  ],
  "hasMore": true,
  "hasIntegrations": true,
  "warning": "<string>",
  "githubSelectedAccess": [
    {
      "installation_id": 123,
      "account_login": "<string>",
      "manage_url": "<string>"
    }
  ]
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}