Update a registry secret
Changes the fields you send and keeps the rest. A new token replaces the saved one. Anything that changes what the registry is asked with (the registry, the sign-in type, the username or the token) clears verified_at; a new label keeps it.
Path parameters
The id of a CoreStack Enterprise environment. Not the same number as a site row id. At least 1.
The id of a registry secret of this environment, as the list answers it. Digits only. At least 1.
Body
How the registry signs in.
http-basicbearergithub-oauthgitlab-tokenUp to 255 characters.
Up to 255 characters.
Up to 4,096 characters.
Up to 255 characters.
Returns
200 The credential after the change.
Fields of the 200 answer
One saved registry credential. Never its token or its username.
Fields
How the registry signs in.
http-basicbearergithub-oauthgitlab-tokenAt least 1.
Always composer on these endpoints.
The 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.
The registry's host, in lower case, with its port when that is not 443.
Always an empty string for a Composer registry.
When the registry last accepted the credential, in UTC. Null when it has not been checked since it last changed. 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 | forbidden | The person is not allowed to do this. |
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 | none | Check the id. You see only what your account can reach. |
409 | exists | It already exists. Use the existing one. |
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/environments/1311/deploy-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/environments/1311/deploy-secrets/318', [
'label' => 'Harbour & Finch packages',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/environments/1311/deploy-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/environments/1311/deploy-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"
}{
"message": "Not found."
}{
"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.