Update a company registry secret
Changes the fields you send, keeps the rest and answers the whole list. verify true on its own checks the saved credential with its registry without changing it.
Path parameters
The id of a company you belong to or manage. Digits only. At least 1.
The id of a registry secret of this company, 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.
For an agency only, also give the credential to the sites it manages for its clients.
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 company's registry secrets after the change, with verification when the registry was asked.
Fields of the 200 answer
Fields of each item
http-basicbearergithub-oauthgitlab-tokennullnpmcomposerThe last four characters of the token. Null for a token shorter than 12 characters.
An npm registry's HTTPS URL, with one trailing slash; a Composer registry's host. Both in lower case.
The npm scope the credential is for. An empty string for the default registry and for Composer.
Fields
Environments that have a credential of their own for this registry.
What the registry answered. Present only when the request sent verify true.
Fields
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 | forbidden | The person is not allowed to do this. |
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. |
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. |
422 | too_many_secrets | This company already has the most registry secrets it can hold. |
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/companies/1204/deploy-secrets/318 \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"label": "Example packages"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->put('https://manage.corefinity.com/api/corestack/companies/1204/deploy-secrets/318', [
'label' => 'Example packages',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/companies/1204/deploy-secrets/318', {
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
label: 'Example 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/companies/1204/deploy-secrets/318",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"label": "Example packages",
},
)
data = res.json() if res.content else None{
"can_share": true,
"data": [
{
"auth_type": "bearer",
"id": 318,
"kind": "composer",
"label": "Example packages",
"last4": "oken",
"last_used_at": null,
"registry": "repo.example.com",
"scope": "",
"shared_with_managed": false,
"used_by": {
"environments": 1,
"overridden_on": 0
},
"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.