CorefinityCorefinityDocs
Open the Control PanelControl Panel
Marketplace keys · 2 of 8

Update a company's Marketplace keys

Saves the company's own Marketplace keys. The keys are checked with the Magento repository first, and nothing is saved when it refuses them.

PUT/api/companies/{company}/magento-keys

Path parameters

companyintegerRequired

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

Body

private_keystringRequired

The private key, in the same form. It is stored encrypted and never answered.

public_keystringRequired

The public key: 32 characters, 0 to 9 and a to f.

Returns

200 The keys were saved.

Fields of the 200 answer
agencystring or null
can_changebooleanRequired
commerce_sitesobject

The Adobe Commerce sites that use the keys.

Fields
countinteger
sitesarray
entitlementsobjectRequired

What the keys can install.

Fields
checked_atstring or nullRequired

Format: date-time.

commercebooleanRequired
errorstring or nullRequired
open_sourcebooleanRequired
fallbackstring or null
public_key_last4string or nullRequired
sourcestringRequired

Where the keys come from: company for the company's own, none when there are none. Other values name keys the company inherits.

updated_atstring or nullRequired

Format: date-time.

updated_byobject or any or nullRequired

Who saved the keys.

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.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.
502noneRead the message; it says what happened.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl -X PUT https://manage.corefinity.com/api/companies/1204/magento-keys \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "private_key": "fedcba9876543210fedcba9876543210",
    "public_key": "0123456789abcdef0123456789ab3f9a"
  }'
{
  "agency": "own",
  "can_change": true,
  "commerce_sites": {
    "count": 0,
    "sites": []
  },
  "entitlements": {
    "checked_at": "2026-11-19T08:00:00Z",
    "commerce": true,
    "error": null,
    "open_source": true
  },
  "fallback": "none",
  "public_key_last4": "3f9a",
  "source": "company",
  "updated_at": "2026-11-19T08:00:00Z",
  "updated_by": {
    "agency": null,
    "id": 2012,
    "name": "Daniel Reyes"
  },
  "verified_at": "2026-11-19T08:00:00Z"
}
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