Sign in

v4

latestOpenAPI 3.1.02026-08-02261331761.5 KB
Policy Git Repositories

List Policy Repos

Lists all the policy repositories under a given project.

get/v2/projects/{proj_id}/repos

Path parameters

proj_idstring required

Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").

Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").

Query parameters

pageinteger

Page number of the results to fetch, starting at 1.

Page number of the results to fetch, starting at 1.

per_pageinteger

The number of results per page (max 100).

The number of results per page (max 100).

Response

Successful Response

idstring uuid required

Unique id of the policy repo

status'invalid' | 'pending' | 'valid' required

An enumeration.

keystring required

A URL-friendly name of the policy repo (i.e: slug). You will be able to query later using this key instead of the id (UUID) of the policy repo.

urlstring required

The SSH URL of the git repository (e.g. git@github.com:username/repository.git)

main_branch_namestring
activate_when_validatedboolean

if you want to change your policy repository to this repo right after it is validated