Creates a new category

cloudforce_one.threat_events.categories.create() -> CategoryCreateResponse

POST/accounts/{account_id}/cloudforce-one/events/categories/create

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

Cloudforce One WriteCloudforce One Read

ParametersExpand Collapse

account_id: str

Account ID.

kill_chain: float

name: str

mitre_attack: Optional[Sequence[str]]

mitre_capec: Optional[Sequence[str]]

shortname: Optional[str]

ReturnsExpand Collapse

class CategoryCreateResponse: …

kill_chain: float

name: str

uuid: str

mitre_attack: Optional[List[str]]

mitre_capec: Optional[List[str]]

shortname: Optional[str]

Creates a new category

import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
category = client.cloudforce_one.threat_events.categories.create(
    account_id="account_id",
    kill_chain=0,
    name="name",
)
print(category.uuid)

{
  "killChain": 0,
  "name": "name",
  "uuid": "12345678-1234-1234-1234-1234567890ab",
  "mitreAttack": [
    "T1234"
  ],
  "mitreCapec": [
    "123"
  ],
  "shortname": "shortname"
}

Returns Examples

{
  "killChain": 0,
  "name": "name",
  "uuid": "12345678-1234-1234-1234-1234567890ab",
  "mitreAttack": [
    "T1234"
  ],
  "mitreCapec": [
    "123"
  ],
  "shortname": "shortname"
}