Repos API: list Detail repositories and user account info

The repos and user endpoints give you the reference data you need to work with the rest of the API. Use the repos endpoint to discover repo_id values, which are required parameters for the bugs, scans, and rules endpoints. Use the user endpoint to verify your API key and inspect your organization memberships.

GET /public/v1/repos

Returns a paginated list of repositories connected to Detail that the authenticated user can access.

curl "https://api.detail.dev/public/v1/repos" \
  -H "Authorization: Bearer dtl_live_YOUR_KEY"

Query parameters

integer

Number of results to return. Between 1 and 100. Defaults to 50.

integer

Number of results to skip for pagination. Defaults to 0.

Response

Repo[]

Array of repository objects accessible to the authenticated user.

Show Repo fields

string

Unique repository identifier, prefixed with repo_. Use this as the repo_id parameter in other endpoints.

string

Short repository name (without the owner prefix). Example: my-repo.

string

GitHub user or organization that owns the repository. Example: myorg.

string

Fully qualified repository name in owner/repo format. Example: myorg/my-repo.

string

Whether the repository is public or private on GitHub.

string

The default branch Detail scans. Example: main.

string

ID of the Detail organization that owns this repository connection, prefixed with org_.

string

Name of the Detail organization that owns this repository connection.

integer

Total number of repositories accessible to the user, regardless of limit and offset.

Example response

{
  "repos": [
    {
      "id": "repo_abc123",
      "name": "my-repo",
      "ownerName": "myorg",
      "fullName": "myorg/my-repo",
      "visibility": "private",
      "primaryBranch": "main",
      "orgId": "org_xyz789",
      "orgName": "My Organization"
    },
    {
      "id": "repo_def456",
      "name": "api-service",
      "ownerName": "myorg",
      "fullName": "myorg/api-service",
      "visibility": "private",
      "primaryBranch": "main",
      "orgId": "org_xyz789",
      "orgName": "My Organization"
    }
  ],
  "total": 2
}

If you already know the owner/repo slug for a repository, fetch the full list and filter by fullName client-side to find its repo_id. Alternatively, look up the repo ID in Settings → Repositories in the Detail dashboard.

GET /public/v1/user

Returns the authenticated user’s email address and their Detail organization memberships. This is a useful endpoint to verify that your API key is valid and to inspect which organizations you have access to.

curl https://api.detail.dev/public/v1/user \
  -H "Authorization: Bearer dtl_live_YOUR_KEY"

Response

string

The email address associated with the authenticated account.

Org[]

The Detail organizations this user belongs to.

Show Org fields

string

Unique organization identifier, prefixed with org_.

string

Display name of the organization.

Example response

{
  "email": "[email protected]",
  "orgs": [
    {
      "id": "org_xyz789",
      "name": "My Organization"
    }
  ]
}

Overview

Endpoints

Repos API: list Detail repositories and user account info

GET /public/v1/repos

Query parameters

Response

Example response

GET /public/v1/user

Response

Example response

​GET /public/v1/repos

​Query parameters

​Response

​Example response

​GET /public/v1/user

​Response

​Example response

GET /public/v1/repos

Query parameters

Response

Example response

GET /public/v1/user

Response

Example response