Create Policy

POSThttps://api.coralogix.com/mgmt/openapi/5/dataplans/policies/v1

Creates a new data policy.

Authorizations

Authorizationstringheaderrequired

API key authentication

The value is a Coralogix API key. Create a personal or team API key and assign its permissions.

Request

Body

application/json

This data structue is used to create a new policy.

oneOf
• Option 1
• Option 2
• Option 3
object
applicationRule# object
Rule.
archiveRetention# object
Archive retention.
description#string
Optional free-text description of the policy's purpose.
Example: My Policy Description
disabled#boolean

When true, the policy is disabled and will not be evaluated.

logRules# object
Log rules for a policy.
name#stringrequired
Human-readable name for the policy.
Example: My Policy
placement#object

Placement.

oneOf

• Option 1
• Option 2
• Option 3

object

placement.first#object

First.

placement.last#object

Last.

priority#quota.v1.Priorityrequired

TCO priority level assigned to a policy, controlling how data is routed and archived.

Possible values: [PRIORITY_TYPE_UNSPECIFIED, PRIORITY_TYPE_BLOCK, PRIORITY_TYPE_LOW, PRIORITY_TYPE_MEDIUM, PRIORITY_TYPE_HIGH]

priorityOverride# object
Priority override.
spanRules# object
Span rules.
subsystemRule# object
Rule.
targets# object[]
List of data targets/destinations to which this policy routes data.

Response

200400401500application/json

This data structue is obtained when creating a policy.

policy#objectrequired
A policy is a set of rules that define the behavior of the Coralogix system for a specific company.
oneOf
• Option 1
• Option 2
• Option 3
object
policy.applicationRule# object
Rule.
policy.archiveRetention# object
Archive retention.
policy.companyId#int32required
Internal Coralogix company/team identifier that owns this policy.
Example: 1234
policy.createdAt#string
Timestamp (RFC 3339) when the policy was created.
Example: 2021-01-01T00:00:00.000Z
policy.deleted#booleanrequired
Soft-delete marker; when true the policy has been deleted and is no longer applied.
Example: false
policy.description#string
Optional free-text description of the policy's purpose.
Example: My Policy Description
policy.enabled#booleanrequired
Indicates whether the policy is actively evaluated and applied.
Example: true
policy.id#stringrequired
Unique identifier for the policy.
Example: policy_id
policy.logRules# object
Log rules for a policy.
policy.name#stringrequired
Human-readable name for the policy.
Example: My Policy
policy.order#int32required
Ordering priority that determines the sequence in which policies are evaluated.
Example: 1
policy.priority#quota.v1.Priorityrequired
TCO priority level assigned to a policy, controlling how data is routed and archived.
Possible values: [PRIORITY_TYPE_UNSPECIFIED, PRIORITY_TYPE_BLOCK, PRIORITY_TYPE_LOW, PRIORITY_TYPE_MEDIUM, PRIORITY_TYPE_HIGH]
policy.priorityOverride# object
Priority override.
policy.priorityOverrideStatus# object
Priority override status.
policy.spanRules# object
Span rules.
policy.subsystemRule# object
Rule.
policy.targets# object[]
List of data targets/destinations to which this policy routes data.
policy.updatedAt#string
Timestamp (RFC 3339) when the policy was last updated.
Example: 2021-01-01T00:00:00.000Z