List repositories in the project

GET

/projects/{projectId}/repositories

curl --request GET \
  --url https://zkao.io/api/v1/projects/example/repositories \
  --header 'Authorization: Bearer <token>'

• Production
• Staging

Requires scope: read. Limited to the token’s repo allowlist when set.

Authorizations

• bearerAuth

Parameters

Path Parameters

projectId

required

string

Responses

200

OK

Media typeapplication/json

object

repositories

required

Array<object>

object

id

required

string

slug

required

URL segment of the repository inside its project (/orgs/<org>/projects/<project>/repos/<slug>). Unique per project.

string

owner

required

string

name

required

string

url

required

string

defaultBranch

string | null

status

required

ACTIVE | MARKED_FOR_DELETION

string

readiness

required

Whether a scan can start on this repository. A newly added repository is analyzing until a one-time pass over it finishes; launching a scan meanwhile fails with repository_initializing. Poll this endpoint rather than retrying the launch blind.

string

Allowed values: ready analyzing

Example

{
  "repositories": [
    {
      "readiness": "ready"
    }
  ]
}

401

Missing, malformed, expired, or revoked token

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: unauthorized forbidden not_found bad_request conflict insufficient_credits repository_initializing diff_base_required diff_base_not_allowed diff_base_invalid diff_empty rate_limited internal

message

required

string

Example

{
  "error": {
    "code": "unauthorized"
  }
}

403

The token lacks the required scope

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: unauthorized forbidden not_found bad_request conflict insufficient_credits repository_initializing diff_base_required diff_base_not_allowed diff_base_invalid diff_empty rate_limited internal

message

required

string

Example

{
  "error": {
    "code": "unauthorized"
  }
}

404

Resource not in this token’s project or repo allowlist

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: unauthorized forbidden not_found bad_request conflict insufficient_credits repository_initializing diff_base_required diff_base_not_allowed diff_base_invalid diff_empty rate_limited internal

message

required

string

Example

{
  "error": {
    "code": "unauthorized"
  }
}