PEpermit
Policy Git Repositories

Get Policy Repo

Changed on

Gets a single repository matching the given repo_id, if such repository exists.

get/v2/projects/{proj_id}/repos/{repo_id}

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").

repo_idstring required

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

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