Update a site registry secret
Changes the fields you send, keeps the rest and answers the whole list. Anything that changes what the registry is asked with clears verified_at, and verify true on its own checks the saved credential without changing it.
Path parameters
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
The id of a registry secret of this environment, as the list answers it. Digits only. At least 1.
Body
http-basicbearergithub-oauthgitlab-tokenUp to 255 characters.
Up to 255 characters.
Up to 214 characters.
Up to 4,096 characters.
Up to 255 characters.
Ask the registry whether it accepts the credential, after any change in the same request.
Returns
200 The environment's registry secrets after the change, with verification when the registry was asked.
Fields of the 200 answer
Fields of each item
How a Composer registry signs in. Null for npm.
http-basicbearergithub-oauthgitlab-tokennullAt least 1.
npmcomposerThe name you gave the credential.
The last four characters of the token. Null for a token shorter than 12 characters.
When a build last received the credential, in UTC. Format: date-time.
An npm registry's HTTPS URL, with one trailing slash; a Composer registry's host, with its port when that is not 443. Both in lower case.
The npm scope the credential is for, such as @northwind-digital. An empty string for the default registry and for Composer.
When the registry last accepted the credential, in UTC. Null when it has not been checked since it last changed. Format: date-time.
What the registry answered. Present only when the request sent verify true.
Fields
The secret that was checked. At least 1.
What the registry answered, in plain words.
Format: date-time.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | exists | It already exists. Use the existing one. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
422 | secret_invalid | Choose how the registry signs in: http-basic, bearer, github-oauth or gitlab-token. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X PUT https://manage.corefinity.com/api/corestack/sites/1042/deployments/secrets/318 \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"label": "Harbour & Finch packages"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->put('https://manage.corefinity.com/api/corestack/sites/1042/deployments/secrets/318', [
'label' => 'Harbour & Finch packages',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/deployments/secrets/318', {
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
label: 'Harbour & Finch packages',
}),
});
// 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.put(
"https://manage.corefinity.com/api/corestack/sites/1042/deployments/secrets/318",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"label": "Harbour & Finch packages",
},
)
data = res.json() if res.content else None{
"data": [
{
"auth_type": "bearer",
"id": 318,
"kind": "composer",
"label": "Harbour & Finch packages",
"last4": "oken",
"last_used_at": null,
"registry": "repo.example.com",
"scope": "",
"verified_at": null
}
]
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "exists",
"id": 318,
"message": "A registry for this host is already saved. Edit it instead.",
"reason": "exists"
}{
"code": "secret_invalid",
"errors": {
"auth_type": [
"Choose how the registry signs in: http-basic, bearer, github-oauth or gitlab-token."
]
},
"message": "Choose how the registry signs in: http-basic, bearer, github-oauth or gitlab-token.",
"reason": "secret_invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.