PEpermit
Policy Git Repositories

List Policy Repos

Changed on

Lists all the policy repositories under a given project.

get/v2/projects/{proj_id}/repos

Request

  • Base URL
    https://api.permit.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

proj_idstring required

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.

per_pageinteger

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

Changes