Skip to main content
Prisma Documentation Docs

Search documentation

Type to search this documentation.

List repositories accessible to an SCM installation

GET/v1/scm-installations/{installationId}/repositoriesList repositories accessible to an SCM installation

⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️

Lists repositories accessible to the given SCM installation.

Parameters

installationIdstringpathrequired

pattern ^(scminstall_)?([cC][^\s-]{8,}|[a-z0-9]+)$

cursornull | stringquery

Cursor for pagination (opaque, returned from previous response)

limitintegerquery

Maximum repositories to return (default and max 100).

default 100 · maximum 100 · minimum 1

Responses

200Repositories accessible to the installation.application/json
object
dataarray of objectrequired
Show child attributes
Show array items
defaultBranchstringrequired
fullNamestringrequired

Full repository name, e.g. "octocat/hello"

idintegerrequired

Numeric repository ID assigned by the SCM provider

isPrivatebooleanrequired
typestringrequired

const "scm-repository"

paginationobjectrequired
Show child attributes
hasMorebooleanrequired
nextCursornull | stringrequired
Example response
{
  "data": [
    {
      "defaultBranch": "string",
      "fullName": "string",
      "id": 0,
      "isPrivate": true,
      "type": "scm-repository"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "string"
  }
}
401Missing or invalid authorization token.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
404Installation not found or not accessible.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
422The SCM provider rejected the repository listing request.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
Documentation menu