ProductSearchCTIX

Network live

CTIXPOST

Create Task

POSThttps://cs-testv2.cyware.com/ctixapi/ingestion/tasks/

Creates a task for a threat data object.

Body Parameters

Name	Type	Required	Description
text	string	required	Pass the description of the task to be performed.
priority	string	optional	Pass the priority of the task.
status	string	optional	Pass the status of the task.
type	string	optional	Pass the type of the threat data object. For example: indicator, malware, vulnerability, campaign, and more.
object_id	string	optional	Pass the ID of the threat data object to associate the task.
deadline	number	optional	Pass the deadline of the task.
assignee	string	required	Pass the ID of a user to assign the task.

Playground

Request parameters

Edit values here before running any snippet below (cURL, JavaScript, or Python). Code blocks are reference only — your inputs above are what gets sent.

CTIXConnect to Intel ExchangeRequired to change data

Credentials required for POST

Open API (HMAC signature) · Get credentials from Cyware Admin → Open API → Generate Credentials.

Base URL

Access ID *Secret Key *

Signature and Expires are generated when you run a request. Access ID and Secret Key stay in memory for this tab only.

Credentials from Authentication auto-fill here for this product. If fields are empty after connecting, refresh this page or open the product docs again.

Request body (JSON)Valid JSON

cURL

curl --request POST \
  --url "https://cs-testv2.cyware.com/ctixapi/ingestion/tasks/?AccessID=%3Cyour%20access%20id%3E&Signature=%3Cyour%20signature%3E&Expires=%3Cyour%20expires%3E" \
  --data '{
  "text": "Verify this indicator!",
  "priority": "high",
  "status": "not_started",
  "type": "indicator",
  "object_id": "92686150-58e5-4f15-be64-f3e123efd825",
  "deadline": 1633393469,
  "assignee": "58a66a94-fe9b-4928-ba44-d38fda6f06f3"
}'

View-only example — running live API calls requires a role with snippet testing access.

JavaScript

const url = "https://cs-testv2.cyware.com/ctixapi/ingestion/tasks/?AccessID=%3Cyour%20access%20id%3E&Signature=%3Cyour%20signature%3E&Expires=%3Cyour%20expires%3E";

const response = await fetch(url, {
  method: "POST",
  headers: {},
  body: JSON.stringify({
    "text": "Verify this indicator!",
    "priority": "high",
    "status": "not_started",
    "type": "indicator",
    "object_id": "92686150-58e5-4f15-be64-f3e123efd825",
    "deadline": 1633393469,
    "assignee": "58a66a94-fe9b-4928-ba44-d38fda6f06f3"
  }),
});

const text = await response.text();
let data;
try { data = JSON.parse(text); } catch { data = text; }
console.log(response.status, data);

View-only example — running live API calls requires a role with snippet testing access.

Python

import requests

url = "https://cs-testv2.cyware.com/ctixapi/ingestion/tasks/"
params = {
    "AccessID": "<your access id>",
    "Signature": "<your signature>",
    "Expires": "<your expires>"
}
headers = {}
payload = {
  "text": "Verify this indicator!",
  "priority": "high",
  "status": "not_started",
  "type": "indicator",
  "object_id": "92686150-58e5-4f15-be64-f3e123efd825",
  "deadline": 1633393469,
  "assignee": "58a66a94-fe9b-4928-ba44-d38fda6f06f3"
}
response = requests.request("POST", url, params=params, headers=headers, json=payload)
print(response.status_code)
print(response.text)

View-only example — running live API calls requires a role with snippet testing access.

Request Body

{
  "text": "Verify this indicator!",
  "priority": "high",
  "status": "not_started",
  "type": "indicator",
  "object_id": "92686150-58e5-4f15-be64-f3e123efd825",
  "deadline": 1633393469,
  "assignee": "58a66a94-fe9b-4928-ba44-d38fda6f06f3"
}

View-only example — running live API calls requires a role with snippet testing access.

Example Response

{
  "id": "0434c6f6-fa28-4d5f-9e0d-d3f4c1ffcb5a",
  "created": 1630394661,
  "modified": 1630394661,
  "created_by": "(unknown)",
  "assignee": "5555f14c-6130-4e58-a2da-33e1a85b5a64",
  "text": "Verify this indicator!",
  "priority": "high",
  "status": "",
  "deadline": 1633393469,
  "closure_comment": {},
  "completed_on": {},
  "type": "indicator",
  "object_id": "92686150-58e5-4f15-be64-f3e123efd825",
  "is_removed": 0
}

View-only example — running live API calls requires a role with snippet testing access.