CorefinityCorefinityDocs
Open the Control PanelControl Panel
Variables and secrets · 3 of 8

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.

PUT/api/corestack/sites/{site}/deployments/secrets/{secret}

Path parameters

siteintegerRequired

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.

secretintegerRequired

The id of a registry secret of this environment, 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.

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 environment's registry secrets after the change, with verification when the registry was asked.

Fields of the 200 answer
dataarray of objectsRequired
Fields of each item
auth_typestring or nullRequired

How a Composer registry signs in. Null for npm.

http-basicbearergithub-oauthgitlab-tokennull
idintegerRequired

At least 1.

kindstringRequired
npmcomposer
labelstringRequired

The name you gave the credential.

last4string or nullRequired

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

last_used_atstring or nullRequired

When a build last received the credential, in UTC. Format: date-time.

registrystringRequired

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.

scopestringRequired

The npm scope the credential is for, such as @northwind-digital. An empty string for the default registry and for Composer.

verified_atstring or nullRequired

When the registry last accepted the credential, in UTC. Null when it has not been checked since it last changed. Format: date-time.

verificationobject

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

Fields
idintegerRequired

The secret that was checked. At least 1.

messagestringRequired

What the registry answered, in plain words.

verifiedbooleanRequired
verified_atstring or nullRequired

Format: date-time.

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.
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.
409managed_elsewhereThis site is read-only here. Change it in the control panel that manages it.
422secret_invalidChoose how the registry signs in: http-basic, bearer, github-oauth or gitlab-token.
422invalidFix the field named in field; errors says why.
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/sites/1042/deployments/secrets/318 \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Harbour & Finch packages"
  }'
{
  "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
    }
  ]
}
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