API

This page describes Reblaze's API namespaces and endpoints. It assumes you are already familiar with the information contained here, about internal data structures and API usage.

This page is provided for reference purposes. By default, every Reblaze planet includes an instance of Swagger UI, which provides this same information with additional interactive features (building curl commands, submitting API calls directly, etc). Read more about this.

API namespaces: overview

The various namespaces within the API can be organized into three categories of settings. The category listings below include links to more information about the settings themselves; the API calls are documented below.

Namespaces for security settings:

• ACL Profiles

• Actions

• Content Filter Profiles

• Content Filter Rules

• Dynamic Rules

• Flow Control Policies

• Global Filters

• Rate Limit Rules

• Security Policies

Namespaces for site-related settings:

• Backend Services (the services that Reblaze is protecting)

• Certificates (for managing SSL certificates)

• Edge Functions (for running custom Lua code)

• Load Balancers (managing SSL associated with load balancers)

• Proxy Templates (parameters for the overall architecture of Reblaze)

• Server Groups (site-level properties)

Namespaces for other capabilities:

• Accounts: for user management

• Configs: for administration of configurations, the fundamental internal data structure

• Data queries: for API access to traffic data

• Database: for management of versioning

• Planets: for planet-level settings such as interactive challenges

• Tags: for retrieval of tag data

• Tools: for miscellaneous capabilities

Namespaces for security settings

ACL Profiles

Get ACL Profiles

Get all ACL Profiles in a configuration

GET/api/v4.0/conf/{config}/acl-profiles

Path parameters

config*Config

Response

200422

ACL Profiles retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/acl-profiles', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify ACL Profiles

Updates an existing set of ACL Profiles for a configuration

PUT/api/v4.0/conf/{config}/acl-profiles

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

ACL Profiles updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/acl-profiles', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Create ACL Profiles

Create a complete set of ACL Profiles for a configuration

POST/api/v4.0/conf/{config}/acl-profiles

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

ACL Profiles created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/acl-profiles', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Delete ACL Profiles

Delete all ACL Profiles in a configuration

DELETE/api/v4.0/conf/{config}/acl-profiles

Path parameters

config*Config

Response

200422

ACL Profiles deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/acl-profiles', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get single ACL Profile

Get an individual ACL Profile (not the entire set) from the specified configuration

GET/api/v4.0/conf/{config}/acl-profiles/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

ACL Profile retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/acl-profiles/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify a single ACL Profile

Update an individual ACL Profile within a configuration

PUT/api/v4.0/conf/{config}/acl-profiles/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

ACL Profile updated successfully

Body

application/json

message*Response message

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/acl-profiles/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Response

{
  "message": "text"
}

Create single ACL Profile

Create an individual ACL Profile within a configuration

POST/api/v4.0/conf/{config}/acl-profiles/{entry_id}

Path parameters

config*Config

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

ACL Profile created successfully

Body

application/json

message*Response message

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/acl-profiles/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "message": "text"
}

Delete single ACL Profile

Delete an individual ACL Profile (not the entire set) from the specified configuration

DELETE/api/v4.0/conf/{config}/acl-profiles/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

ACL Profile deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/acl-profiles/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get ACL Profiles version list

Get list of versions of ACL Profiles in a configuration

GET/api/v4.0/conf/{config}/acl-profiles/versions

Path parameters

config*Config

Response

200422

ACL Profiles version list retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/acl-profiles/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get version of ACL Profile

Get a specific version of an ACL Profile

GET/api/v4.0/conf/{config}/acl-profiles/versions/{version}

Path parameters

config*Config

version*Version

Response

200422

ACL Profile retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/acl-profiles/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Revert an ACL Profile to the specified version

Set a previous ACL Profile version to be the current one

PUT/api/v4.0/conf/{config}/acl-profiles/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

ACL Profile reversion was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/acl-profiles/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Actions

Get Actions

Get all Actions in a configuration

GET/api/v4.0/conf/{config}/actions

Path parameters

config*Config

Response

200422

Actions retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/actions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify Actions

Update an existing set of Actions for a configuration

PUT/api/v4.0/conf/{config}/actions

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Actions updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/actions', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Create Actions

Create complete set of Actions for a configuration

POST/api/v4.0/conf/{config}/actions

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Actions created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/actions', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Delete Actions

Delete all Actions in a configuration

DELETE/api/v4.0/conf/{config}/actions

Path parameters

config*Config

Response

200422

Actions deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/actions', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get single Action

Get an individual Action from the specified configuration

GET/api/v4.0/conf/{config}/actions/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Action retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/actions/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify a single Action

Update an individual Action within a configuration

PUT/api/v4.0/conf/{config}/actions/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Action updated successfully

Body

application/json

message*Response message

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/actions/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "message": "text"
}

Create single Action

Create an individual Action within a configuration

POST/api/v4.0/conf/{config}/actions/{entry_id}

Path parameters

config*Config

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Action created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/actions/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Delete single Action

Delete an individual Action from the specified configuration

DELETE/api/v4.0/conf/{config}/actions/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Action deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/actions/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get Actions version list

Get list of versions of Actions in a configuration

GET/api/v4.0/conf/{config}/actions/versions

Path parameters

config*Config

Response

200422

Actions version list retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/actions/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get version of Actions

Get a specific version of an Action

GET/api/v4.0/conf/{config}/actions/versions/{version}

Path parameters

config*Config

version*Version

Response

200422

Action version retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/actions/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Revert Actions to the specified version

Set a previous Actions version to be the current one

PUT/api/v4.0/conf/{config}/actions/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

Actions reversion was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/actions/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Content Filter Profiles

Get Content Filter Profiles

Get all Content Filter Profiles in a configuration

GET/api/v4.0/conf/{config}/content-filter-profiles

Path parameters

config*Config

Response

200422

Content Filter Profiles retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-profiles', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify Content Filter Profiles

Update an existing set of Content Filter Profiles for a configuration

PUT/api/v4.0/conf/{config}/content-filter-profiles

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Content Filter Profiles updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-profiles', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Create Content Filter Profiles

Create a complete set of Content Filter Profiles for a configuration

POST/api/v4.0/conf/{config}/content-filter-profiles

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Content Filter Profiles created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-profiles', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Delete Content Filter Profiles

Delete all Content Filter Profiles in a configuration

DELETE/api/v4.0/conf/{config}/content-filter-profiles

Path parameters

config*Config

Response

200422

Content Filter Profiles deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-profiles', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get single Content Filter Profile

Get a Content Filter Profile from the specified configuration

GET/api/v4.0/conf/{config}/content-filter-profiles/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Content Filter Profile retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-profiles/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify a single Content Filter Profile

Update an individual Content Filter Profile within a configuration

PUT/api/v4.0/conf/{config}/content-filter-profiles/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Content Filter Profile updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-profiles/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Create single Content Filter Profile

Create an individual Content Filter Profile within a configuration

POST/api/v4.0/conf/{config}/content-filter-profiles/{entry_id}

Path parameters

config*Config

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Content Filter Profile created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-profiles/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Delete single Content Filter Profile

Delete an individual Content Filter Profile from the specified configuration

DELETE/api/v4.0/conf/{config}/content-filter-profiles/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Content Filter Profile deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-profiles/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get Content Filter Profiles version list

Get list of versions of Content Filter Profiles in a configuration

GET/api/v4.0/conf/{config}/content-filter-profiles/versions

Path parameters

config*Config

Response

200422

Content Filter Profiles version list retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-profiles/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get version of Content Filter Profile

Get a specific version of a Content Filter Profile

GET/api/v4.0/conf/{config}/content-filter-profiles/versions/{version}

Path parameters

config*Config

version*Version

Response

200422

Content Filter Profile retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-profiles/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Revert a Content Filter Profile to the specified version

Set a previous Content Filter Profile version to be the current one

PUT/api/v4.0/conf/{config}/content-filter-profiles/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

Content Filter Profile reversion was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-profiles/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Content Filter Rules

Get Content Filter Rules

Get all Content Filter Rules in a configuration

GET/api/v4.0/conf/{config}/content-filter-rules

Path parameters

config*Config

Response

200422

Content Filter Rules retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify Content Filter Rules

Update an existing set of Content Filter Rules for a configuration

PUT/api/v4.0/conf/{config}/content-filter-rules

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Content Filter Rules updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Create Content Filter Rules

Create a complete set of Content Filter Rules for a configuration

POST/api/v4.0/conf/{config}/content-filter-rules

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Content Filter Rules created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Delete Content Filter Rules

Delete all Content Filter Rules in a configuration

DELETE/api/v4.0/conf/{config}/content-filter-rules

Path parameters

config*Config

Response

200422

Content Filter Rules deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get single Content Filter Rule

Get a Content Filter Rule from the specified configuration

GET/api/v4.0/conf/{config}/content-filter-rules/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Content Filter Rule retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get Content Filter Rules version list

Get list of versions of Content Filter Rules in a configuration

GET/api/v4.0/conf/{config}/content-filter-rules/versions

Path parameters

config*Config

Response

200422

Content Filter Rules version list retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify a single Content Filter Rule

Update an individual Content Filter Rule within a configuration

PUT/api/v4.0/conf/{config}/content-filter-rules/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Content Filter Rule updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Create single Content Filter Rule

Create an individual Content Filter Rule within a configuration

POST/api/v4.0/conf/{config}/content-filter-rules/{entry_id}

Path parameters

config*Config

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Content Filter Rule created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Delete single Content Filter Rule

Delete an individual Content Filter Rule from the specified configuration

DELETE/api/v4.0/conf/{config}/content-filter-rules/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Content Filter Rule deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get version of Content Filter Rule set

Get a specific version of a Content Filter Rule set

GET/api/v4.0/conf/{config}/content-filter-rules/versions/{version}

Path parameters

config*Config

version*Version

Response

200422

Content Filter Rule set retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Revert a Content Filter Rule set to the specified version

Set a previous Content Filter Rule set version to be the current one

PUT/api/v4.0/conf/{config}/content-filter-rules/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

Content Filter Rule reversion was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Dynamic Rules

Get Dynamic Rules

Get all Dynamic Rules in a configuration

GET/api/v4.0/conf/{config}/dynamic-rules

Path parameters

config*Config

Response

200400422500

Dynamic Rules retrieved successfully

Body

application/json

action*Action

active*Active

descriptionDescription

excludeExclude

id*Id

Unique id

includeInclude

name*Name

tagsTags

target*Target

threshold*Threshold

timeframe*Timeframe

ttl*Ttl

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/dynamic-rules', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "action": "text",
    "active": false,
    "description": "text",
    "exclude": [
      "text"
    ],
    "id": "text",
    "include": [
      "text"
    ],
    "name": "text",
    "tags": [
      "text"
    ],
    "target": "text"
  }
]

Get specific Dynamic Rule

Get a Dynamic Rule from the specified configuration

GET/api/v4.0/conf/{config}/dynamic-rules/{entry_id}

Path parameters

config*Config

entry_id*Id

Response

200400422500

Dynamic Rule retrieved successfully

Body

application/json

action*Action

active*Active

descriptionDescription

excludeExclude

id*Id

Unique id

includeInclude

name*Name

tagsTags

target*Target

threshold*Threshold

timeframe*Timeframe

ttl*Ttl

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/dynamic-rules/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "action": "text",
  "active": false,
  "description": "text",
  "exclude": [
    "text"
  ],
  "id": "text",
  "include": [
    "text"
  ],
  "name": "text",
  "tags": [
    "text"
  ],
  "target": "text"
}

Modify Dynamic Rule

Update an individual Dynamic Rule within a configuration

PUT/api/v4.0/conf/{config}/dynamic-rules/{entry_id}

Path parameters

config*Config

entry_id*Id

Body

application/json

action*Action

active*Active

descriptionDescription

excludeExclude

id*Id

Unique id

includeInclude

name*Name

tagsTags

target*Target

threshold*Threshold

timeframe*Timeframe

ttl*Ttl

Response

204400422500

Dynamic Rule updated successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/dynamic-rules/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "id": "text",
      "name": "text",
      "active": false,
      "target": "text",
      "action": "text"
    }),
});
const data = await response.json();

Create Dynamic Rule

Create an individual Dynamic Rule within a configuration

POST/api/v4.0/conf/{config}/dynamic-rules/{entry_id}

Path parameters

config*Config

entry_id*Id

Body

application/json

action*Action

active*Active

descriptionDescription

excludeExclude

id*Id

Unique id

includeInclude

name*Name

tagsTags

target*Target

threshold*Threshold

timeframe*Timeframe

ttl*Ttl

Response

201400422500

Dynamic Rule created successfully

Body

application/json

id*Id

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/dynamic-rules/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "id": "text",
      "name": "text",
      "active": false,
      "target": "text",
      "action": "text"
    }),
});
const data = await response.json();

Response

{
  "id": "text"
}

Delete Dynamic Rule

Delete an individual Dynamic Rule from the specified configuration

DELETE/api/v4.0/conf/{config}/dynamic-rules/{entry_id}

Path parameters

config*Config

entry_id*Id

Response

204400422500

Dynamic Rule deleted successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/dynamic-rules/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Flow Control Policies

Get Flow Control Policies

Get all Flow Control Policies in a configuration

GET/api/v4.0/conf/{config}/flow-control-policies

Path parameters

config*Config

Response

200422

Flow Control Policies retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/flow-control-policies', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify Flow Control Policies

Update an existing set of Flow Control Policies for a configuration

PUT/api/v4.0/conf/{config}/flow-control-policies

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Flow Control Policies updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/flow-control-policies', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Create Flow Control Policies

Create a complete set of Flow Control Policies for a configuration

POST/api/v4.0/conf/{config}/flow-control-policies

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Flow Control Policies created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/flow-control-policies', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Delete Flow Control Policies

Delete all Flow Control Policies in a configuration

DELETE/api/v4.0/conf/{config}/flow-control-policies

Path parameters

config*Config

Response

200422

Flow Control Policies deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/flow-control-policies', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get specific Flow Control Policy

Get a Flow Control Policy from the specified configuration

GET/api/v4.0/conf/{config}/flow-control-policies/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Flow Control Policy retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/flow-control-policies/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify a single Flow Control Policy

Update an individual Flow Control Policy within a configuration

PUT/api/v4.0/conf/{config}/flow-control-policies/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Flow Control Policy updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/flow-control-policies/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Create single Flow Control Policy

Create an individual Flow Control Policy within a configuration

POST/api/v4.0/conf/{config}/flow-control-policies/{entry_id}

Path parameters

config*Config

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Flow Control Policy created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/flow-control-policies/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Delete single Flow Control Policy

Delete an individual Flow Control Policy from the specified configuration

DELETE/api/v4.0/conf/{config}/flow-control-policies/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Flow Control Policy deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/flow-control-policies/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get Flow Control Policies version list

Get list of versions of Flow Control Policies in a configuration

GET/api/v4.0/conf/{config}/flow-control-policies/versions

Path parameters

config*Config

Response

200422

Flow Control Policies version list retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/flow-control-policies/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get version of Flow Control Policy

Get a specific version of a Flow Control Policy

GET/api/v4.0/conf/{config}/flow-control-policies/versions/{version}

Path parameters

config*Config

version*Version

Response

200422

Flow Control Policy retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/flow-control-policies/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Revert a Flow Control Policy to the specified version

Set a previous Flow Control Policy version to be the current one

PUT/api/v4.0/conf/{config}/flow-control-policies/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

Flow Control Policy reversion was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/flow-control-policies/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Global Filters

Get Global Filters

Get all Global Filters in a configuration

GET/api/v4.0/conf/{config}/global-filters

Path parameters

config*Config

Response

200422

Global Filters retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/global-filters', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify Global Filters

Update an existing set of Global Filters for a configuration

PUT/api/v4.0/conf/{config}/global-filters

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Global Filters updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/global-filters', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Create Global Filters

Create a complete set of Global Filters for a configuration

POST/api/v4.0/conf/{config}/global-filters

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Global Filters created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/global-filters', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Delete Global Filters

Delete all Global Filters in a configuration

DELETE/api/v4.0/conf/{config}/global-filters

Path parameters

config*Config

Response

200422

Global Filters deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/global-filters', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get specific Global Filter

Get a Global Filter from the specified configuration

GET/api/v4.0/conf/{config}/global-filters/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Global Filter retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/global-filters/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify a single Global Filter

Update an individual Global Filter within a configuration

PUT/api/v4.0/conf/{config}/global-filters/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Global Filter updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/global-filters/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Create single Global Filter

Create an individual Global Filter within a configuration

POST/api/v4.0/conf/{config}/global-filters/{entry_id}

Path parameters

config*Config

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Global Filter created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/global-filters/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Delete single Global Filter

Delete an individual Global Filter from the specified configuration

DELETE/api/v4.0/conf/{config}/global-filters/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Global Filter deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/global-filters/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get Global Filters version list

Get list of versions of Global Filters in a configuration

GET/api/v4.0/conf/{config}/global-filters/versions

Path parameters

config*Config

Response

200422

Global Filters version list retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/global-filters/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get version of Global Filter

Get a specific version of a Global Filter

GET/api/v4.0/conf/{config}/global-filters/versions/{version}

Path parameters

config*Config

version*Version

Response

200422

Global Filter retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/global-filters/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Revert a Global Filter to the specified version

Set a previous Global Filter version to be the current one

PUT/api/v4.0/conf/{config}/global-filters/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

Global Filter reversion was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/global-filters/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Rate Limit Rules

Get Rate Limit Rules

Get all Rate Limit Rules in a configuration

GET/api/v4.0/conf/{config}/rate-limit-rules

Path parameters

config*Config

Response

200422

Rate Limit Rules retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/rate-limit-rules', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify Rate Limit Rules

Update an existing set of Rate Limit Rules for a configuration

PUT/api/v4.0/conf/{config}/rate-limit-rules

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Rate Limit Rules updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/rate-limit-rules', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Create Rate Limit Rules

Create a complete set of Rate Limit Rules for a configuration

POST/api/v4.0/conf/{config}/rate-limit-rules

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Rate Limit Rules created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/rate-limit-rules', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Delete Rate Limit Rules

Delete all Rate Limit Rules in a configuration

DELETE/api/v4.0/conf/{config}/rate-limit-rules

Path parameters

config*Config

Response

200422

Rate Limit Rules deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/rate-limit-rules', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get specific Rate Limit Rule

Get a Rate Limit Rule from the specified configuration

GET/api/v4.0/conf/{config}/rate-limit-rules/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Rate Limit Rule retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/rate-limit-rules/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify a single Rate Limit Rule

Update an individual Rate Limit Rule within a configuration

PUT/api/v4.0/conf/{config}/rate-limit-rules/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Rate Limit Rule updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/rate-limit-rules/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Create single Rate Limit Rule

Create an individual Rate Limit Rule within a configuration

POST/api/v4.0/conf/{config}/rate-limit-rules/{entry_id}

Path parameters

config*Config

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Rate Limit Rule created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/rate-limit-rules/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Delete single Rate Limit Rule

Delete an individual Rate Limit Rule from the specified configuration

DELETE/api/v4.0/conf/{config}/rate-limit-rules/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Rate Limit Rule deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/rate-limit-rules/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get Rate Limit Rules version list

Get list of versions of Rate Limit Rules in a configuration

GET/api/v4.0/conf/{config}/rate-limit-rules/versions

Path parameters

config*Config

Response

200422

Rate Limit Rules version list retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/rate-limit-rules/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get version of Rate Limit Rule

Get a specific version of a Rate Limit Rule

GET/api/v4.0/conf/{config}/rate-limit-rules/versions/{version}

Path parameters

config*Config

version*Version

Response

200422

Rate Limit Rule retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/rate-limit-rules/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Revert a Rate Limit Rule to the specified version

Set a previous Rate Limit Rule version to be the current one

PUT/api/v4.0/conf/{config}/rate-limit-rules/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

Rate Limit Rule reversion was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/rate-limit-rules/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Security Policies

Get Security Policies

Get all Security Policies in a configuration

GET/api/v4.0/conf/{config}/security-policies

Path parameters

config*Config

Response

200422

Security Policies retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/security-policies', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify Security Policies

Update an existing set of Security Policies for a configuration

PUT/api/v4.0/conf/{config}/security-policies

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Security Policies updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/security-policies', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Create Security Policies

Create a complete set of Security Policies for a configuration

POST/api/v4.0/conf/{config}/security-policies

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Security Policies created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/security-policies', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Delete Security Policies

Delete all Security Policies in a configuration

DELETE/api/v4.0/conf/{config}/security-policies

Path parameters

config*Config

Response

200422

Security Policies deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/security-policies', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get specific Security Policy

Get a Security Policy from the specified configuration

GET/api/v4.0/conf/{config}/security-policies/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Security Policy retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/security-policies/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify a single Security Policy

Update an individual Security Policy within a configuration

PUT/api/v4.0/conf/{config}/security-policies/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Security Policy updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/security-policies/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Create single Security Policy

Create an individual Security Policy within a configuration

POST/api/v4.0/conf/{config}/security-policies/{entry_id}

Path parameters

config*Config

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Security Policy created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/security-policies/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Delete single Security Policy

Delete an individual Security Policy from the specified configuration

DELETE/api/v4.0/conf/{config}/security-policies/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Security Policy deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/security-policies/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get Security Policies version list

Get list of versions of Security Policies in a configuration

GET/api/v4.0/conf/{config}/security-policies/versions

Path parameters

config*Config

Response

200422

Security Policies version list retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/security-policies/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get version of Security Policy

Get a specific version of a Security Policy

GET/api/v4.0/conf/{config}/security-policies/versions/{version}

Path parameters

config*Config

version*Version

Response

200422

Security Policy retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/security-policies/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Revert a Security Policy to the specified version

Set a previous Security Policy version to be the current one

PUT/api/v4.0/conf/{config}/security-policies/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

Security Policy reversion was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/security-policies/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Namespaces for site-related settings

Backend Services

Get Backend Services

Get all Backend Services in a configuration

GET/api/v4.0/conf/{config}/backend-services

Path parameters

config*Config

Response

200422

Backend Services retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify Backend Services

Updates an existing set of Backend Services for a configuration

PUT/api/v4.0/conf/{config}/backend-services

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Backend Services updated successfully

Body

application/json

message*Response message

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Response

{
  "message": "text"
}

Create Backend Services

Create a complete set of Backend Services for a configuration

POST/api/v4.0/conf/{config}/backend-services

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Backend Services created successfully

Body

application/json

message*Response message

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Response

{
  "message": "text"
}

Delete Backend Services

Delete all Backend Services in a configuration

DELETE/api/v4.0/conf/{config}/backend-services

Path parameters

config*Config

Response

200422

Backend Services deleted successfully

Body

application/json

message*Response message

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "text"
}

Get single Backend Service

Get an individual Backend Service from the specified configuration

GET/api/v4.0/conf/{config}/backend-services/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Backend Service retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify a single Backend Service

Update an individual Backend Service within a configuration

PUT/api/v4.0/conf/{config}/backend-services/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Backend Service updated successfully

Body

application/json

message*Response message

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "message": "text"
}

Create single Backend Service

Create an individual Backend Service within a configuration

POST/api/v4.0/conf/{config}/backend-services/{entry_id}

Path parameters

config*Config

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Backend Service created successfully

Body

application/json

message*Response message

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "message": "text"
}

Delete single Backend Service

Delete an individual Backend Service from the specified configuration

DELETE/api/v4.0/conf/{config}/backend-services/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Backend Service deleted successfully

Body

application/json

message*Response message

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "text"
}

Get Backend Services version list

Get list of versions of Backend Services in a configuration

GET/api/v4.0/conf/{config}/backend-services/versions

Path parameters

config*Config

Response

200422

Backend Services version list retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get version of Backend Service

Get a specific version of a Backend Service

GET/api/v4.0/conf/{config}/backend-services/versions/{version}

Path parameters

config*Config

version*Version

Response

200422

Backend Service retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Revert a Backend Service to the specified version

Set a previous Backend Service version to be the current one

PUT/api/v4.0/conf/{config}/backend-services/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

Backend Service reversion was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Get Backend Service usage by ID

Show where a specific Backend Service is being used

GET/api/v4.0/conf/{config}/backend-services/{entry_id}/links

Path parameters

config*Config

entry_id*Id

Response

200400422500

Backend Service usage retrieved successfully

Body

application/json

db_key*Db Key

Key of object containing certificate or provider/ load balancer

item*Item

Entry type (site/load balancer region)

name*Name

Object name (site/load balancer name

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/backend-services/{entry_id}/links', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "db_key": "text",
    "item": "text",
    "name": "text"
  }
]

Certificates

List Certificates

Get a list of the planet's certificates for a configuration

GET/api/v4.0/conf/{config}/certificates

Path parameters

config*Config

Response

200422500

Certificates were retrieved successfully

Body

application/json

cert_bodyCert Body

expiresExpires

id*Id

Unique id

issuerIssuer

le_auto_renewLe Auto Renew

le_auto_replaceLe Auto Replace

le_hashLe Hash

private_keyPrivate Key

provider_linksProvider Links

sanSan

subjectSubject

uploadedUploaded

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/certificates', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "cert_body": "text",
    "expires": "2024-05-09",
    "id": "text",
    "issuer": "text",
    "le_auto_renew": true,
    "le_auto_replace": true,
    "le_hash": "text",
    "private_key": "text",
    "provider_links": [
      {
        "link": "text",
        "provider": "text",
        "region": "text"
      }
    ],
    "san": [
      "text"
    ],
    "subject": "text",
    "uploaded": "2024-05-09T00:29:03.829Z"
  }
]

Get Certificate

Get a specific Certificate for a configuration

GET/api/v4.0/conf/{config}/certificates/{entry_id}

Path parameters

config*Config

entry_id*Id

Response

200422500

Certificate was retrieved successfully

Body

application/json

cert_bodyCert Body

expiresExpires

id*Id

Unique id

issuerIssuer

le_auto_renewLe Auto Renew

le_auto_replaceLe Auto Replace

le_hashLe Hash

private_keyPrivate Key

provider_linksProvider Links

sanSan

subjectSubject

uploadedUploaded

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/certificates/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "cert_body": "text",
  "expires": "2024-05-09",
  "id": "text",
  "issuer": "text",
  "le_auto_renew": true,
  "le_auto_replace": true,
  "le_hash": "text",
  "private_key": "text",
  "provider_links": [
    {
      "link": "text",
      "provider": "text",
      "region": "text"
    }
  ],
  "san": [
    "text"
  ],
  "subject": "text",
  "uploaded": "2024-05-09T00:29:03.829Z"
}

Modify Certificate

Change settings for a specific certificate. ("le_" parameters refer to Let's Encrypt.)

PUT/api/v4.0/conf/{config}/certificates/{entry_id}

Path parameters

config*Config

entry_id*Id

Query parameters

Response

204422

Certificate modified successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/certificates/{entry_id}', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Add Certificate

Can accept domains and replace_cert can be sent as queries. Load from pfx, pems or create certificate (generate or upload and replace based on input parameters). ("le_" parameters refer to Let's Encrypt.)

POST/api/v4.0/conf/{config}/certificates/{entry_id}

Path parameters

config*Config

entry_id*Id

Query parameters

Body

application/json

cert_bodyCert Body

expiresExpires

id*Id

Unique id

issuerIssuer

le_auto_renewLe Auto Renew

le_auto_replaceLe Auto Replace

le_hashLe Hash

private_keyPrivate Key

provider_linksProvider Links

sanSan

subjectSubject

uploadedUploaded

Response

201422

Certificate created

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/certificates/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "id": "text"
    }),
});
const data = await response.json();

Delete Certificate

Delete an individual Certificate from the specified configuration

DELETE/api/v4.0/conf/{config}/certificates/{entry_id}

Path parameters

config*Config

entry_id*Id

Response

204400422500

Certificate deleted successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/certificates/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get certificate usage

Get usage of a specific Certificate by its id

GET/api/v4.0/conf/{config}/certificates/{entry_id}/links

Path parameters

config*Config

entry_id*Id

Response

200400422500

Certificate info retrieved successfully

Body

application/json

db_key*Db Key

Key of object containing certificate or provider/ load balancer

item*Item

Entry type (site/load balancer region)

name*Name

Object name (site/load balancer name

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/certificates/{entry_id}/links', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "db_key": "text",
    "item": "text",
    "name": "text"
  }
]

Get Certificate Pfx

GET/api/v4.0/conf/{config}/certificates/{entry_id}/pfx

Path parameters

config*Config

entry_id*Id

Response

200400422500

Certificate's pfx retrieved successfully

Body

application/json

Response Export Api V3 Reblaze Configs Config D Certificates E Id Pfx Get

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/certificates/{entry_id}/pfx', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

"binary"

Edge Functions

Get Edge Functions

Get all Edge Functions in a configuration

GET/api/v4.0/conf/{config}/edge-functions

Path parameters

config*Config

Response

200422

Edge Functions retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify Edge Functions

Update an existing set of Edge Functions for a configuration

PUT/api/v4.0/conf/{config}/edge-functions

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Edge Functions updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Create Edge Functions

Create a complete set of Edge Functions for a configuration

POST/api/v4.0/conf/{config}/edge-functions

Path parameters

config*Config

Body

application/json

An array of JSON objects corresponding to the entries of the specific document

any

Response

200422

Edge Functions created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Delete Edge Functions

Delete all Edge Functions in a configuration

DELETE/api/v4.0/conf/{config}/edge-functions

Path parameters

config*Config

Response

200422

Edge Functions deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get specific Edge Function

Get an Edge Function from the specified configuration

GET/api/v4.0/conf/{config}/edge-functions/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Edge Function retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Modify a single Edge Function

Update an individual Edge Function within a configuration

PUT/api/v4.0/conf/{config}/edge-functions/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Edge Function updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Create single Edge Function

Create an individual Edge Function within a configuration

POST/api/v4.0/conf/{config}/edge-functions/{entry_id}

Path parameters

config*Config

Body

application/json

A JSON object corresponding to the entry of the specific document

any

Response

200422

Edge Function created successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Delete single Edge Function

Delete an individual Edge Function from the specified configuration

DELETE/api/v4.0/conf/{config}/edge-functions/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Edge Function deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get Edge Functions version list

Get list of versions of Edge Functions in a configuration

GET/api/v4.0/conf/{config}/edge-functions/versions

Path parameters

config*Config

Response

200422

Edge Functions version list retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get version of Edge Function

Get a specific version of an Edge Function

GET/api/v4.0/conf/{config}/edge-functions/versions/{version}

Path parameters

config*Config

version*Version

Response

200422

Edge Function retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Revert an Edge Function to the specified version

Set a previous Edge Function version to be the current one

PUT/api/v4.0/conf/{config}/edge-functions/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

Edge Function reversion was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Get usage of an Edge Function

Get usage of an individual Edge Function within a configuration

GET/api/v4.0/conf/{config}/edge-functions/{entry_id}/links

Path parameters

config*Config

entry_id*Id

Response

200400422500

Edge Function usage retrieved successfully

Body

application/json

db_key*Db Key

Key of object containing certificate or provider/ load balancer

item*Item

Entry type (site/load balancer region)

name*Name

Object name (site/load balancer name

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/edge-functions/{entry_id}/links', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "db_key": "text",
    "item": "text",
    "name": "text"
  }
]

Load Balancers

Get Load Balancers

Get all Load Balancers in a configuration

GET/api/v4.0/conf/{config}/load-balancers

Path parameters

config*Config

Response

200400500

Load Balancers retrieved successfully

Body

application/json

certificates*Certificates

default_certificate*Default Certificate

dns_name*Dns Name

listener_name*Listener Name

listener_port*Listener Port

Port in AWS or IP in GCP

load_balancer_type*Load Balancer Type

classicapplication

max_certificates*Max Certificates

name*Name

provider*CloudProviderEnum

An enumeration.

awsgcp

region*Region

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/load-balancers', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "certificates": [
      "text"
    ],
    "default_certificate": "text",
    "dns_name": "text",
    "listener_name": "text",
    "load_balancer_type": "classic",
    "name": "text",
    "provider": "aws",
    "region": "text"
  }
]

Add Certificate

Add a certificate to a Load Balancer

PUT/api/v4.0/conf/{config}/load-balancers/{entry_name}/certificates/{certificate_id}

Path parameters

config*Config

certificate_id*Certificate Id

load_balancer_name*Load Balancer Name

Query parameters

Response

204422500

Successfully added certificate to Load Balancer

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/load-balancers/{entry_name}/certificates/{certificate_id}', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Detach certificate

Detach a non-default certificate from the Load Balancer

DELETE/api/v4.0/conf/{config}/load-balancers/{entry_name}/certificates

Path parameters

config*Config

load_balancer_name*Load Balancer Name

Query parameters

Response

204422500

Successfully detached certificate from Load Balancer

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/load-balancers/{entry_name}/certificates', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Proxy Templates

Get Proxy Templates

Get all Proxy Templates in a configuration

GET/api/v4.0/conf/{config}/proxy-templates

Path parameters

config*Config

Response

200400422500

Proxy Templates retrieved successfully

Body

application/json

acao_header*Acao Header

client_body_timeout*Client Body Timeout

client_header_buffer_size*Client Header Buffer Size

client_header_timeout*Client Header Timeout

client_max_body_size*Client Max Body Size

conf_specificConf Specific

custom_listener*Custom Listener

descriptionDescription

keepalive_timeout*Keepalive Timeout

large_client_header_buffers_count*Large Client Header Buffers Count

large_client_header_buffers_size*Large Client Header Buffers Size

limit_req_burst*Limit Req Burst

limit_req_rate*Limit Req Rate

mask_headers*Mask Headers

name*Name

proxy_connect_timeout*Proxy Connect Timeout

proxy_read_timeout*Proxy Read Timeout

proxy_send_timeout*Proxy Send Timeout

send_timeout*Send Timeout

ssl_conf_specificSsl Conf Specific

upstream_host*Upstream Host

xff_header_name*Xff Header Name

xrealip_header_name*Xrealip Header Name

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/proxy-templates', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "acao_header": false,
    "client_body_timeout": "text",
    "client_header_buffer_size": "text",
    "client_header_timeout": "text",
    "client_max_body_size": "text",
    "conf_specific": "text",
    "custom_listener": false,
    "description": "text",
    "keepalive_timeout": "text",
    "large_client_header_buffers_count": "text",
    "large_client_header_buffers_size": "text",
    "limit_req_burst": "text",
    "limit_req_rate": "text",
    "mask_headers": "text",
    "name": "text",
    "proxy_connect_timeout": "text",
    "proxy_read_timeout": "text",
    "proxy_send_timeout": "text",
    "send_timeout": "text",
    "ssl_conf_specific": "text",
    "upstream_host": "text",
    "xff_header_name": "text",
    "xrealip_header_name": "text"
  }
]

Get Proxy Template

Get a Proxy Template from the specified configuration

GET/api/v4.0/conf/{config}/proxy-templates/{entry_id}

Path parameters

config*Config

entry_id*Id

Response

200400422500

Proxy Template retrieved successfully

Body

application/json

acao_header*Acao Header

client_body_timeout*Client Body Timeout

client_header_buffer_size*Client Header Buffer Size

client_header_timeout*Client Header Timeout

client_max_body_size*Client Max Body Size

conf_specificConf Specific

custom_listener*Custom Listener

descriptionDescription

keepalive_timeout*Keepalive Timeout

large_client_header_buffers_count*Large Client Header Buffers Count

large_client_header_buffers_size*Large Client Header Buffers Size

limit_req_burst*Limit Req Burst

limit_req_rate*Limit Req Rate

mask_headers*Mask Headers

name*Name

proxy_connect_timeout*Proxy Connect Timeout

proxy_read_timeout*Proxy Read Timeout

proxy_send_timeout*Proxy Send Timeout

send_timeout*Send Timeout

ssl_conf_specificSsl Conf Specific

upstream_host*Upstream Host

xff_header_name*Xff Header Name

xrealip_header_name*Xrealip Header Name

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/proxy-templates/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "acao_header": false,
  "client_body_timeout": "text",
  "client_header_buffer_size": "text",
  "client_header_timeout": "text",
  "client_max_body_size": "text",
  "conf_specific": "text",
  "custom_listener": false,
  "description": "text",
  "keepalive_timeout": "text",
  "large_client_header_buffers_count": "text",
  "large_client_header_buffers_size": "text",
  "limit_req_burst": "text",
  "limit_req_rate": "text",
  "mask_headers": "text",
  "name": "text",
  "proxy_connect_timeout": "text",
  "proxy_read_timeout": "text",
  "proxy_send_timeout": "text",
  "send_timeout": "text",
  "ssl_conf_specific": "text",
  "upstream_host": "text",
  "xff_header_name": "text",
  "xrealip_header_name": "text"
}

Create Proxy Template

Create an individual Proxy Template within a configuration

POST/api/v4.0/conf/{config}/proxy-templates/{entry_id}

Path parameters

config*Config

entry_id*Id

Body

application/json

acao_header*Acao Header

client_body_timeout*Client Body Timeout

client_header_buffer_size*Client Header Buffer Size

client_header_timeout*Client Header Timeout

client_max_body_size*Client Max Body Size

conf_specificConf Specific

custom_listener*Custom Listener

descriptionDescription

keepalive_timeout*Keepalive Timeout

large_client_header_buffers_count*Large Client Header Buffers Count

large_client_header_buffers_size*Large Client Header Buffers Size

limit_req_burst*Limit Req Burst

limit_req_rate*Limit Req Rate

mask_headers*Mask Headers

name*Name

proxy_connect_timeout*Proxy Connect Timeout

proxy_read_timeout*Proxy Read Timeout

proxy_send_timeout*Proxy Send Timeout

send_timeout*Send Timeout

ssl_conf_specificSsl Conf Specific

upstream_host*Upstream Host

xff_header_name*Xff Header Name

xrealip_header_name*Xrealip Header Name

Response

201400422500

Proxy Template created successfully

Body

application/json

id*Id

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/proxy-templates/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "acao_header": false,
      "xff_header_name": "text",
      "proxy_connect_timeout": "text",
      "proxy_read_timeout": "text",
      "proxy_send_timeout": "text",
      "upstream_host": "text",
      "client_body_timeout": "text",
      "client_header_timeout": "text",
      "keepalive_timeout": "text",
      "send_timeout": "text",
      "client_max_body_size": "text",
      "limit_req_rate": "text",
      "limit_req_burst": "text",
      "mask_headers": "text",
      "xrealip_header_name": "text",
      "custom_listener": false,
      "client_header_buffer_size": "text",
      "large_client_header_buffers_count": "text",
      "large_client_header_buffers_size": "text"
    }),
});
const data = await response.json();

Response

{
  "id": "text"
}

Modify Proxy Template

Update an individual Proxy Template within a configuration

PUT/api/v4.0/conf/{config}/proxy-templates/{entry_id}

Path parameters

config*Config

entry_id*Id

Body

application/json

acao_header*Acao Header

client_body_timeout*Client Body Timeout

client_header_buffer_size*Client Header Buffer Size

client_header_timeout*Client Header Timeout

client_max_body_size*Client Max Body Size

conf_specificConf Specific

custom_listener*Custom Listener

descriptionDescription

keepalive_timeout*Keepalive Timeout

large_client_header_buffers_count*Large Client Header Buffers Count

large_client_header_buffers_size*Large Client Header Buffers Size

limit_req_burst*Limit Req Burst

limit_req_rate*Limit Req Rate

mask_headers*Mask Headers

name*Name

proxy_connect_timeout*Proxy Connect Timeout

proxy_read_timeout*Proxy Read Timeout

proxy_send_timeout*Proxy Send Timeout

send_timeout*Send Timeout

ssl_conf_specificSsl Conf Specific

upstream_host*Upstream Host

xff_header_name*Xff Header Name

xrealip_header_name*Xrealip Header Name

Response

204400422500

Proxy Template updated successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/proxy-templates/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "acao_header": false,
      "xff_header_name": "text",
      "proxy_connect_timeout": "text",
      "proxy_read_timeout": "text",
      "proxy_send_timeout": "text",
      "upstream_host": "text",
      "client_body_timeout": "text",
      "client_header_timeout": "text",
      "keepalive_timeout": "text",
      "send_timeout": "text",
      "client_max_body_size": "text",
      "limit_req_rate": "text",
      "limit_req_burst": "text",
      "mask_headers": "text",
      "xrealip_header_name": "text",
      "custom_listener": false,
      "client_header_buffer_size": "text",
      "large_client_header_buffers_count": "text",
      "large_client_header_buffers_size": "text"
    }),
});
const data = await response.json();

Delete Proxy Template

Delete an individual Proxy Template from the specified configuration

DELETE/api/v4.0/conf/{config}/proxy-templates/{entry_id}

Path parameters

config*Config

entry_id*Id

Response

204400422500

Proxy Template deleted successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/proxy-templates/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get usage of a Proxy Template

Get list of sites that use the specified Proxy Template

GET/api/v4.0/conf/{config}/proxy-templates/{entry_id}/links

Path parameters

config*Config

entry_id*Id

Response

200400422500

Proxy Template usage retrieved successfully

Body

application/json

db_key*Db Key

Key of object containing certificate or provider/ load balancer

item*Item

Entry type (site/load balancer region)

name*Name

Object name (site/load balancer name

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/proxy-templates/{entry_id}/links', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "db_key": "text",
    "item": "text",
    "name": "text"
  }
]

Server Groups

Get all Server Groups (sites/domains)

Get all Server Groups in a configuration. (Usually, each Server Group represents a site or domain.)

GET/api/v4.0/conf/{config}/server-groups

Path parameters

config*Config

Response

200400422500

Server Groups retrieved successfully

Body

application/json

challenge_cookie_domain*Challenge's Cookie Domain

The domain for a challenge's cookie.

descriptionDescription

id*Id

Unique id

mobile_sdkMobile SDK Settings

ID of Mobile SDK used for site.

name*Name

site name

proxy_template*Proxy Template

ID of Proxy template used for site.

routing_profile*Routing profile

ID of Routing profile used for site.

security_policy*Security Policy

ID of security policy applied on site.

server_names*Server Names

host names corresponding to the site.

ssl_certificateSSL Certificate

ID of SSL certificate attached to site.

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/server-groups', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "challenge_cookie_domain": "text",
    "description": "text",
    "id": "text",
    "mobile_sdk": "text",
    "name": "text",
    "proxy_template": "text",
    "routing_profile": "text",
    "security_policy": "text",
    "server_names": [
      "text"
    ],
    "ssl_certificate": "text"
  }
]

Get a specific Server Group (a specific site/domain)

Get a Server Group from the specified configuration

GET/api/v4.0/conf/{config}/server-groups/{entry_id}

Path parameters

config*Config

entry_id*Id

Response

200400422500

Server Group retrieved successfully

Body

application/json

challenge_cookie_domain*Challenge's Cookie Domain

The domain for a challenge's cookie.

descriptionDescription

id*Id

Unique id

mobile_sdkMobile SDK Settings

ID of Mobile SDK used for site.

name*Name

site name

proxy_template*Proxy Template

ID of Proxy template used for site.

routing_profile*Routing profile

ID of Routing profile used for site.

security_policy*Security Policy

ID of security policy applied on site.

server_names*Server Names

host names corresponding to the site.

ssl_certificateSSL Certificate

ID of SSL certificate attached to site.

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/server-groups/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "challenge_cookie_domain": "text",
  "description": "text",
  "id": "text",
  "mobile_sdk": "text",
  "name": "text",
  "proxy_template": "text",
  "routing_profile": "text",
  "security_policy": "text",
  "server_names": [
    "text"
  ],
  "ssl_certificate": "text"
}

Modify Server Group (a site/domain)

Update an individual Server Group within a configuration

PUT/api/v4.0/conf/{config}/server-groups/{entry_id}

Path parameters

config*Config

entry_id*Id

Body

application/json

challenge_cookie_domain*Challenge's Cookie Domain

The domain for a challenge's cookie.

descriptionDescription

id*Id

Unique id

mobile_sdkMobile SDK Settings

ID of Mobile SDK used for site.

name*Name

site name

proxy_template*Proxy Template

ID of Proxy template used for site.

routing_profile*Routing profile

ID of Routing profile used for site.

security_policy*Security Policy

ID of security policy applied on site.

server_names*Server Names

host names corresponding to the site.

ssl_certificateSSL Certificate

ID of SSL certificate attached to site.

Response

204400422500

Server Group updated successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/server-groups/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "id": "text",
      "name": "text",
      "server_names": [
        "text"
      ],
      "security_policy": "text",
      "routing_profile": "text",
      "proxy_template": "text",
      "challenge_cookie_domain": "text"
    }),
});
const data = await response.json();

Create Server Group (a site/domain)

Create a Server Group within a configuration

POST/api/v4.0/conf/{config}/server-groups/{entry_id}

Path parameters

config*Config

entry_id*Id

Body

application/json

challenge_cookie_domain*Challenge's Cookie Domain

The domain for a challenge's cookie.

descriptionDescription

id*Id

Unique id

mobile_sdkMobile SDK Settings

ID of Mobile SDK used for site.

name*Name

site name

proxy_template*Proxy Template

ID of Proxy template used for site.

routing_profile*Routing profile

ID of Routing profile used for site.

security_policy*Security Policy

ID of security policy applied on site.

server_names*Server Names

host names corresponding to the site.

ssl_certificateSSL Certificate

ID of SSL certificate attached to site.

Response

201400422500

Server Group created successfully

Body

application/json

id*Id

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/server-groups/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "id": "text",
      "name": "text",
      "server_names": [
        "text"
      ],
      "security_policy": "text",
      "routing_profile": "text",
      "proxy_template": "text",
      "challenge_cookie_domain": "text"
    }),
});
const data = await response.json();

Response

{
  "id": "text"
}

Delete a Server Group (a site/domain)

Delete a Server Group from the specified configuration

DELETE/api/v4.0/conf/{config}/server-groups/{entry_id}

Path parameters

config*Config

entry_id*Id

Response

204400422500

Server Group deleted successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/server-groups/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Namespaces for other capabilities

Accounts

Get list of user accounts

GET/api/v4.0/accounts/users

Response

200400422500

User accounts were retrieved successfully

Body

application/json

id*Id

name*Name

users*Users

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/users', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "id": "text",
    "name": "text",
    "users": [
      {
        "contact_name": "text",
        "email": "[e-mail]",
        "id": "text",
        "mobile": "text",
        "org_id": "text",
        "org_name": "text"
      }
    ]
  }
]

Get user details

GET/api/v4.0/accounts/{entry_id}

Path parameters

entry_id*Account Id

Account ID

Response

200400422500

User account details were retrieved successfully

Body

application/json

acl*Acl

contact_name*Contact Name

email*Email

id*Id

mobile*Mobile

org_id*Org Id

org_name*Org Name

otpseed*Otpseed

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "contact_name": "text",
  "email": "[e-mail]",
  "id": "text",
  "mobile": "text",
  "org_id": "text",
  "org_name": "text",
  "otpseed": "text"
}

Modify user account

Update details of a user account

PUT/api/v4.0/accounts/{entry_id}

Path parameters

entry_id*Account Id

Account ID

Body

application/json

acl*Acl

contact_name*Contact Name

mobile*Mobile

Response

200400422500

User account updated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "mobile": "text",
      "contact_name": "text"
    }),
});
const data = await response.json();

Create new user

Create new user account

POST/api/v4.0/accounts/users

Body

application/json

acl*Acl

contact_name*Contact Name

email*Email

mobile*Mobile

org_id*Org Id

Response

200201400422500

New user was created successfully

Body

application/json

id*Id

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/users', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "mobile": "text",
      "contact_name": "text",
      "email": "[e-mail]",
      "org_id": "text"
    }),
});
const data = await response.json();

Response

{
  "id": "text"
}

Delete user account

Delete user account by user id

DELETE/api/v4.0/accounts/{entry_id}

Path parameters

entry_id*Account Id

Account ID

Response

200400422500

User account was deleted successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Get all API keys associated with the planet

GET/api/v4.0/accounts/api-keys

Response

200400422500

API keys were received successfully

Body

application/json

account_id*Account Id

created_by*Created By

created_time*Created Time

email*Email

id*Id

key*Key

title*Title

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/api-keys', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "account_id": "text",
    "created_by": "text",
    "created_time": 0,
    "email": "text",
    "id": "text",
    "key": "text",
    "title": "text"
  }
]

Get API keys for a user account

GET/api/v4.0/accounts/{entry_id}/api-keys

Path parameters

entry_id*Account Id

Account ID

Response

200400422500

API keys for specified user were retrieved successfully

Body

application/json

account_id*Account Id

created_by*Created By

created_time*Created Time

email*Email

id*Id

key*Key

title*Title

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/{entry_id}/api-keys', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "account_id": "text",
    "created_by": "text",
    "created_time": 0,
    "email": "text",
    "id": "text",
    "key": "text",
    "title": "text"
  }
]

Generate account API key

POST/api/v4.0/accounts/{entry_id}/api-keys

Path parameters

entry_id*Account Id

Account ID

Body

application/json

title*Title

Response

200400422500

API key for specified user was generated successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/{entry_id}/api-keys', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "title": "text"
    }),
});
const data = await response.json();

Revoke an account API key

PUT/api/v4.0/accounts/api-keys/{entry_id}

Path parameters

entry_id*Key Id

API key ID

Response

200400422500

API key was revoked successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/api-keys/{entry_id}', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Get SSO Config for the planet

GET/api/v4.0/accounts/sso

Response

200400422500

SSO config retrieved successfully

Body

application/json

enabledEnabled

Is that profile enabled or not.

params*Params

SSO provider parameters

SSOOAuthConfigParamsSSOSAML2ConfigParamsResponse

protocol*all of

SSO protocol

provider*all of

SSO provider

title*Title

Title of the SSO profile that will be displayed on the login page.

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/sso', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "enabled": false,
  "params": {
    "client_id": "text",
    "client_secret": "text",
    "issuer": "text",
    "roles": [
      {
        "idp_group": "text",
        "reblaze_groups": [
          "reblaze-events-viewer"
        ]
      }
    ],
    "roles_claim_key": "text"
  },
  "protocol": {},
  "provider": {},
  "title": "text"
}

Add/Update SSO Config of OAuth2 protocol for the domain

POST/api/v4.0/accounts/sso/oauth2

Body

application/json

enabledEnabled

Is that profile enabled or not.

params*Params

SSO provider OAuth2 protocol parameters

protocol*all of

SSO protocol

provider*all of

SSO provider

title*Title

Title of the SSO profile that will be displayed on the login page.

Response

201400422500

SSO config was updated successfully

Body

application/json

cert_thumbprintCert Thumbprint

Certificate thumbprint to show user certificate if correct. Is used only for user output.

code*Code

message*Message

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/sso/oauth2', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "title": "text",
      "provider": {},
      "protocol": {},
      "params": {
        "client_id": "text",
        "client_secret": "text",
        "issuer": "text"
      }
    }),
});
const data = await response.json();

Response

{
  "cert_thumbprint": "text",
  "message": "text"
}

Add/Update SSO Config of SAML2 protocol for the domain

POST/api/v4.0/accounts/sso/saml2

Body

application/json

enabledEnabled

Is that profile enabled or not.

params*Params

SSO provider SAML2 protocol parameters

protocol*all of

SSO protocol

provider*all of

SSO provider

title*Title

Title of the SSO profile that will be displayed on the login page.

Response

201400422500

SSO config was updated successfully

Body

application/json

cert_thumbprintCert Thumbprint

Certificate thumbprint to show user certificate if correct. Is used only for user output.

code*Code

message*Message

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/accounts/sso/saml2', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "title": "text",
      "provider": {},
      "protocol": {},
      "params": {
        "tenantId": "text",
        "entityId": "text",
        "login_url": "https://example.com"
      }
    }),
});
const data = await response.json();

Response

{
  "cert_thumbprint": "text",
  "message": "text"
}

Configs

Get Configurations

Get detailed list of existing configurations

GET/api/v4.0/conf/configs

Response

200

List of configurations was retrieved successfully

Body

application/json

dateDate

description*Description

id*Id

logsLogs

versionVersion

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/configs', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "date": "2024-05-09T00:29:03.829Z",
    "description": "text",
    "id": "text",
    "logs": [
      {
        "date": "2024-05-09T00:29:03.829Z",
        "version": "text"
      }
    ],
    "version": "text"
  }
]

Get Configuration

Retrieve a complete configuration

GET/api/v4.0/conf/configs/{config}

Path parameters

config*Config

Response

200422

Configuration retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/configs/{config}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get Versions of a Config

Get all versions of a given configuration

GET/api/v4.0/conf/configs/{config}/versions

Path parameters

config*Config

Response

200422

Config versions retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/configs/{config}/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Revert a Config to a Version

Set a previous version of a configuration to be the current one

PUT/api/v4.0/conf/configs/{config}/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

Configuration reversion was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/configs/{config}/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Data queries

Get timeline

Get timeline (time_period, sessions, remote_addr, all_hits, blocked, origin_blocked, challenge, is_human, statuses stats, origin statuses stats, bytes_sent) by a filter

GET/api/v4.0/data/timeline

Query parameters

Header parameters

Response

2004XX

Timeline has been received successfully

Body

application/json

data*object

status*integer

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/data/timeline', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": {
    "results": []
  }
}

Get log lines

Get log lines by a filter

GET/api/v4.0/data/logs

Query parameters

Header parameters

Response

2004XX

Logs has been received successfully

Body

application/json

data*object

status*integer

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/data/logs', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": {
    "results": []
  }
}

Get stats

Get stats (time_period, counter, hostname, bandwidth, latency) by a filter

GET/api/v4.0/data/stats

Query parameters

Header parameters

Response

2004XX

Stats has been received successfully

Body

application/json

data*object

status*integer

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/data/stats', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": {
    "results": []
  }
}

Get Topx

Get topx stats by a filter

GET/api/v4.0/data/topx

Query parameters

Header parameters

Response

2004XX

Topx has been received successfully

Body

application/json

data*object

status*integer

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/data/topx', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": {
    "results": []
  }
}

Query any database directly

Send final query (SQL or other syntax) to get any custom results from any DB.

POST/api/v4.0/data/query

Header parameters

Body

application/json

query*one of

stringobject

Response

2004XX

Query has been run successfully

Body

application/json

data*object

status*integer

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/data/query', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "query": "text"
    }),
});
const data = await response.json();

Response

{
  "data": {
    "results": []
  }
}

Query any database directly

Send string with filters to get filters into JSON format.

POST/api/v4.0/data/timeline/parse

Body

application/json

query*one of

stringobject

Response

2004XX

Filter string has been converted successfullylters

Body

application/json

object

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/data/timeline/parse', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "query": "text"
    }),
});
const data = await response.json();

Database

Db Resource Get

Get the list of existing namespaces

GET/api/v4.0/db

Response

200

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Db Query Resource Get

List all existing versions of namespaces

GET/api/v4.0/db/versions

Response

200

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Ns Resource Get

Get a complete namespace

GET/api/v4.0/db/{entry_id}

Path parameters

nsname*Nsname

Response

200422

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Ns Resource Post

Create a non-existing namespace from data

POST/api/v4.0/db/{entry_id}

Path parameters

nsname*Nsname

Body

application/json

DB

Response

200422

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Ns Resource Put

Merge data into a namespace

PUT/api/v4.0/db/{entry_id}

Path parameters

nsname*Nsname

Body

application/json

DB

Response

200422

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Ns Resource Delete

Delete an existing namespace

DELETE/api/v4.0/db/{entry_id}

Path parameters

nsname*Nsname

Response

200422

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Ns Version Resource Get

Get a given version of a namespace

GET/api/v4.0/db/{entry_id}/versions/{version}

Path parameters

nsname*Nsname

version*Version

Response

200422

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db/{entry_id}/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Ns Version Revert Resource Put

Set a previous version of a namespace to be the current one

PUT/api/v4.0/db/{entry_id}/versions/{version}/revert

Path parameters

nsname*Nsname

version*Version

Response

200422

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db/{entry_id}/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Key Resource Get

Retrieve a given key's value from a given namespace

GET/api/v4.0/db/{entry_id}/{key}

Path parameters

nsname*Nsname

key*Key

Response

200422

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db/{entry_id}/{key}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Key Resource Put

Create or update the value of a key

PUT/api/v4.0/db/{entry_id}/{key}

Path parameters

nsname*Nsname

key*Key

Response

200422

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db/{entry_id}/{key}', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Key Resource Delete

Delete a key

DELETE/api/v4.0/db/{entry_id}/{key}

Path parameters

nsname*Nsname

key*Key

Response

200422

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db/{entry_id}/{key}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Keys List Versions Resource Get

Get all versions of a given key in namespace

GET/api/v4.0/db/{entry_id}/{key}/versions

Path parameters

nsname*Nsname

key*Key

Response

200422

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/db/{entry_id}/{key}/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Planet

Get Planet

Get planet-wide settings and values

GET/api/v4.0/conf/{config}/planets

Path parameters

config*Config

Response

200400422500

Planet info successfully retrieved

Body

application/json

ichallenge*IChallenge

name*Name

trusted_nets*Trusted Nets

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/planets', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "ichallenge": {
    "palette": [
      "text"
    ]
  },
  "name": "text",
  "trusted_nets": [
    {
      "address": "text",
      "comment": "text"
    }
  ]
}

Modify Planet

Modify settings of a planet

PUT/api/v4.0/conf/{config}/planets

Path parameters

config*Config

Body

application/json

ichallenge*IChallenge

name*Name

trusted_nets*Trusted Nets

Response

204400422500

Planet updated successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/planets', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "trusted_nets": [
        {
          "address": "text",
          "comment": "text"
        }
      ],
      "ichallenge": {
        "palette": [
          "text"
        ]
      }
    }),
});
const data = await response.json();

Get a single Planet

Get an individual single planet

GET/api/v4.0/conf/{config}/planets/{entry_id}

Path parameters

config*Config

Response

200400422500

Planet returned successfully

Body

application/json

ichallenge*IChallenge

name*Name

trusted_nets*Trusted Nets

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/planets/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "ichallenge": {
    "palette": [
      "text"
    ]
  },
  "name": "text",
  "trusted_nets": [
    {
      "address": "text",
      "comment": "text"
    }
  ]
}

Modify a single Planet

PUT/api/v4.0/conf/{config}/planets/{entry_id}

Path parameters

config*Config

Body

application/json

ichallenge*IChallenge

name*Name

trusted_nets*Trusted Nets

Response

204400422500

Planet updated successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/planets/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "trusted_nets": [
        {
          "address": "text",
          "comment": "text"
        }
      ],
      "ichallenge": {
        "palette": [
          "text"
        ]
      }
    }),
});
const data = await response.json();

Tags

Get All Tags

Get all tags in the system

GET/api/v4.0/conf/{config}/tags

Path parameters

config*Config

Response

200422

Tags retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/tags', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get Tag Usage

Get usage of a tag in the configuration

GET/api/v4.0/conf/{config}/tags/{entry_id}

Path parameters

config*Config

entry_id*Tag

Response

200422

Tag usage was retrieved successfully

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/conf/{config}/tags/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Tools

Extract Pfx

POST/api/v4.0/tools/certificates/extractpfx

Body

multipart/form-data

fileName*Filename

password*Password

Response

201422500

Request was successful

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/tools/certificates/extractpfx', {
    method: 'POST',
    headers: {
      "Content-Type": "multipart/form-data"
    },
    body: JSON.stringify({
      "fileName": "binary",
      "password": "text"
    }),
});
const data = await response.json();

Get Planet DNS information

Get DNS zone ID and predefined records

GET/api/v4.0/tools/dns-information

Response

200400500

Successfully retrieved DNS information

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/tools/dns-information', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Fetch Resource Get

Fetch an URL. Try to download from GCP and if we can't to do that then download directly from link

GET/api/v4.0/tools/fetch

Query parameters

Response

200422

Successful Response

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/tools/fetch', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Publish

Publish the current version of the specified configuration

PUT/api/v4.0/tools/publish/{config}

Path parameters

config*Config

Header parameters

Body

application/json

nameName

urlUrl

Response

204422500

Configuration published successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/tools/publish/{config}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();

Publish Version of Configuration

Publish the specified version of a configuration

PUT/api/v4.0/tools/publish/{config}/{version}

Path parameters

config*Config

version*Version

Header parameters

Body

application/json

nameName

urlUrl

Response

204422500

Configuration version published successfully

Request

JavaScriptCurl

const response = await fetch('/api/v4.0/tools/publish/{config}/{version}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {}
    ]),
});
const data = await response.json();