CorefinityCorefinityDocs
Open the Control PanelControl Panel
Deployment templates · 3 of 15

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.

PUT/api/corestack/companies/{company}/deploy-secrets/{secret}

Path parameters

companyintegerRequired

The id of a company you belong to or manage. Digits only. At least 1.

secretintegerRequired

The id of a registry secret of this company, as the list answers it. Digits only. At least 1.

Body

auth_typestring
http-basicbearergithub-oauthgitlab-token
labelstring

Up to 255 characters.

registrystring

Up to 255 characters.

scopestring

Up to 214 characters.

shared_with_managedboolean

For an agency only, also give the credential to the sites it manages for its clients.

tokenstring

Up to 4,096 characters.

usernamestring

Up to 255 characters.

verifyboolean

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
can_sharebooleanRequired
dataarray of objectsRequired
Fields of each item
auth_typestring or nullRequired
http-basicbearergithub-oauthgitlab-tokennull
idintegerRequired
kindstringRequired
npmcomposer
labelstringRequired
last4string or nullRequired

The last four characters of the token. Null for a token shorter than 12 characters.

last_used_atstring or nullRequired
registrystringRequired

An npm registry's HTTPS URL, with one trailing slash; a Composer registry's host. Both in lower case.

scopestringRequired

The npm scope the credential is for. An empty string for the default registry and for Composer.

shared_with_managedbooleanRequired
used_byobjectRequired
Fields
environmentsintegerRequired
overridden_onintegerRequired

Environments that have a credential of their own for this registry.

verified_atstring or nullRequired
verificationobject

What the registry answered. Present only when the request sent verify true.

Fields
idintegerRequired
messagestringRequired
verifiedbooleanRequired
verified_atstring or nullRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403forbiddenThe person is not allowed to do this.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409existsIt already exists. Use the existing one.
422secret_invalidChoose how the registry signs in: http-basic, bearer, github-oauth or gitlab-token.
422invalidFix the field named in field; errors says why.
422too_many_secretsThis company already has the most registry secrets it can hold.
429rate_limitedWait 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"
  }'
{
  "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
    }
  ]
}
Try it

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.

Was this helpful?
Open in ClaudeOpen in ChatGPT