Skip to main content
POST
/
security
/
sifter
/
v3
/
protected_networks
Create protected network
curl --request POST \
  --url https://api.gcore.com/security/sifter/v3/protected_networks \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'files=<string>' \
  --form 'network=<string>' \
  --form as_number=123 \
  --form 'comment=<string>' \
  --form files.items='@example-file'
{
  "as_number": 65001,
  "client_id": 150,
  "comment": "Production network for web services",
  "created_at": "2025-06-15T10:30:00Z",
  "documents": [
    {
      "id": 501,
      "name": "network_authorization.pdf"
    },
    {
      "id": 502,
      "name": "service_agreement.pdf"
    }
  ],
  "gre_endpoint": "203.0.113.10",
  "id": 1024,
  "is_active": true,
  "is_error": false,
  "is_processing": false,
  "lifecycle_status": "APPROVED",
  "modified_at": "2025-07-20T14:45:00Z",
  "network": "198.51.100.0/24",
  "profile": {
    "id": 42,
    "name": "Standard DDoS Protection"
  },
  "protection_status": "ACTIVE",
  "status": "ENABLED"
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Body

multipart/form-data
​
files
file[]
required
Required array length: 1 - 5 elements
​
network
string<ipv4network>
required
​
as_number
integer
required
​
comment
string | null

Response

Successful Response

​
id
integer
required

Identifier for the protected network

​
client_id
integer
required

Identifier of the client owning this network

​
network
required

IP network address (IPv4 or IPv6)

​
as_number
integer
required

Autonomous System number associated with the network

Example:

65000

​
gre_endpoint
required

GRE tunnel endpoint IP address

Example:

"172.16.31.10"

​
status
enum<string>
required

Current administrative status of the network

Available options:
PENDING,
ACTIVE,
INACTIVE,
NEED_INFO,
PROCESSING,
ERROR
​
protection_status
enum<string>
required

Current protection status of the network (ACTIVE, INACTIVE, NONE)

Available options:
NONE,
ACTIVE,
INACTIVE,
ACTIVATING,
DEACTIVATING,
UPDATING,
ERROR
​
lifecycle_status
enum<string>
required

Current lifecycle status of the network (PENDING, APPROVED, REJECTED)

Available options:
PENDING,
APPROVED,
REJECTED,
DELETED
​
comment
string | null
required

Optional comment or note about the network

​
documents
ProtectedNetworkDocumentResponse · object[]
required

List of associated documents

​
created_at
string<date-time>
required

Timestamp when the network was created

​
modified_at
string<date-time> | null
required

Timestamp of the last modification

​
profile
ProfileInProtectedNetwork · object
required

Associated protection profile

Example:
{
  "id": 42,
  "name": "Standard DDoS Protection"
}
​
is_active
boolean
required

Whether the network protection is currently active

​
is_processing
boolean
required

Whether the network is currently being processed

​
is_error
boolean
required

Whether the network is in an error state