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.
Path parameters
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
Whether your role may remove a repository.
Fields
Whether your role may add or change a repository.
Fields
Fields of each item
The branch deployed. Null when connection_hidden is true.
True when the repository was set up with a git account you cannot use. You cannot change such a repository.
The agency that set the repository up, when it is hidden and you belong to the company that agency manages. Null otherwise.
The pipeline the repository deploys with.
The git provider, such as github. Null when connection_hidden is true.
The repository's path at the provider. Null when connection_hidden is true.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | scope_required | Use a token with the scope named in scope. |
404 | none | Check the id. You see only what your account can reach. |
429 | rate_limited | Wait 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"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/environments/1311/repositories');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/environments/1311/repositories', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/environments/1311/repositories",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"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
}
]
}{
"message": "Unauthenticated."
}{
"code": "scope_required",
"message": "This access token does not have the destructive scope this needs. Use a token with the destructive scope.",
"reason": "scope_required",
"scope": "destructive"
}{
"message": "Not found."
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}