CorefinityCorefinityDocs
Open the Control PanelControl Panel
Enterprise deployments · 11 of 17

List an environment's repositories

Answers the git repositories the environment deploys from, with whether your role may change them. A repository set up with a git account you cannot use is listed with connection_hidden true and without its provider, repository or branch.

GET/api/environments/{environment}/repositories

Path parameters

environmentintegerRequired

The id of a CoreStack Enterprise environment. Not the same number as a site row id. At least 1.

Returns

200 The repositories, and what your role may do with them.

Fields of the 200 answer
can_manageobjectRequired

Whether your role may remove a repository.

Fields
availablebooleanRequired
reasonstring or nullRequired
can_setobjectRequired

Whether your role may add or change a repository.

Fields
availablebooleanRequired
reasonstring or nullRequired
environment_repositoriesarray of objectsRequired
Fields of each item
branchstring or nullRequired

The branch deployed. Null when connection_hidden is true.

connection_hiddenbooleanRequired

True when the repository was set up with a git account you cannot use. You cannot change such a repository.

connection_ownerstring or nullRequired

The agency that set the repository up, when it is hidden and you belong to the company that agency manages. Null otherwise.

environment_deployment_pipeline_idstring or nullRequired

The pipeline the repository deploys with.

idstringRequired
providerstring or nullRequired

The git provider, such as github. Null when connection_hidden is true.

repostring or nullRequired

The repository's path at the provider. Null when connection_hidden is true.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
404noneCheck the id. You see only what your account can reach.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/environments/1311/repositories \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "can_manage": {
    "available": true,
    "reason": null
  },
  "can_set": {
    "available": true,
    "reason": null
  },
  "environment_repositories": [
    {
      "branch": "main",
      "connection_hidden": false,
      "connection_owner": null,
      "environment_deployment_pipeline_id": "2210",
      "id": "3301",
      "provider": "github",
      "repo": "northwind-digital/harbourandfinch-trade"
    },
    {
      "branch": null,
      "connection_hidden": true,
      "connection_owner": "Northwind Digital",
      "environment_deployment_pipeline_id": "2210",
      "id": "3304",
      "provider": null,
      "repo": null
    }
  ]
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT