CorefinityCorefinityDocs
Open the Control PanelControl Panel
Firewall · 13 of 20

Attach a firewall preset

Attaches a preset at a company, a website, one environment or yourself, so every range of the preset may connect over SSH. The ranges follow the preset as Corefinity updates it.

POST/api/firewall/preset-subscriptions

Body

owner_idintegerRequired

At least 1.

owner_typestringRequired

The level an address is held at. user is yourself.

environmentwebsitecompanyuser
preset_idintegerRequired

The id of a preset, as GET /firewall/presets answers it. At least 1.

Returns

201 The preset was attached. Follow change_id with GET /firewall/changes/{change}.

Fields of the 201 answer
change_idinteger or nullRequired
subscriptionobjectRequired

A preset attached at one owner.

Fields
added_byobjectRequired

Who added an address or made a change.

Fields
namestring or nullRequired

Null when the person has been removed, or when Corefinity support added the address.

on_behalf_ofstring or nullRequired

The person Corefinity support added it for.

supportbooleanRequired

True when Corefinity support added the address for a customer.

created_atstringRequired

Format: date-time.

editablebooleanRequired

Whether you may detach it.

idintegerRequired

The id DELETE /firewall/preset-subscriptions/{subscription} takes.

layerstringRequired
agencycompanywebsiteenvironmentuserpresethttp_auth_rule
ownerobjectRequired

Where an address is held: a company, a website, an environment or a person. http_auth_rule is an address carried over with a password-protected path.

Fields
idintegerRequired

At least 1.

namestringRequired
typestringRequired
companywebsiteenvironmentuserhttp_auth_rule
presetobjectRequired

The published address ranges of a common service, kept up to date by Corefinity.

Fields
descriptionstring or nullRequired
idintegerRequired

At least 1.

namestringRequired
ranges_countintegerRequired

How many ranges the preset holds.

slugstringRequired

The preset's short name. Detaching it asks you to send this back.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403firewall_not_editableYou can see this entry but you cannot change it.
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.
404not_foundNot found.
422firewall_preset_presentThat preset is already attached here.
422invalid_argumentsThe arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again.
429firewall_throttledToo many firewall changes. Wait a minute and try again.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl -X POST https://manage.corefinity.com/api/firewall/preset-subscriptions \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "owner_id": 1204,
    "owner_type": "company",
    "preset_id": 12
  }'
{
  "change_id": 5312,
  "subscription": {
    "added_by": {
      "name": "Eleanor Finch",
      "on_behalf_of": null,
      "support": false
    },
    "created_at": "2026-11-06T09:16:40Z",
    "editable": true,
    "id": 311,
    "layer": "company",
    "owner": {
      "id": 1204,
      "name": "Harbour & Finch",
      "type": "company"
    },
    "preset": {
      "description": "The addresses Bitbucket Pipelines builds connect from.",
      "id": 12,
      "name": "Bitbucket Pipelines",
      "ranges_count": 2,
      "slug": "bitbucket-pipelines"
    }
  }
}
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