Create machine Event

Create a new machine event with the provided event details.

Note: This operation can be performed by integrators or organizations. Organizations may omit organization_id.

Authorization

http

AuthorizationBasic <token>

Go to https://portal.ethiack.com/settings/api and generate your API keys. Simply use username=key, password=secret.

In: header

Request Body

application/json

Event data required to create a new machine event

TypeScript Definitions

Use the request body type in TypeScript.

organization_id?|

The identifier of the organization that owns the event. Required for integrators. Optional for organizations.

Defaultnull

add_assets?boolean

Whether to automatically add all existing assets to the event, including domains as wildcard assets

Defaulttrue

launch_recon?boolean

Whether to automatically launch a recon job for the event. Adds all domains as wildcard assets if not already added.

Defaulttrue

end_date?|

Optional end date for the event in ISO 8601 format (e.g., '2024-12-31T23:59:59Z' or '2024-12-31T23:59:59+00:00'). Must be timezone-aware and in the future

Defaultnull

name?|

Optional custom name for the event. If not provided, a name will be automatically generated.

Defaultnull

Response Body

`application/json`

curl -X POST "https://api.ethiack.com/v1/events/" \  -H "Content-Type: application/json" \  -d '{    "organization_id": null,    "add_assets": true,    "launch_recon": true,    "end_date": null,    "name": null  }'

{
  "code": 0,
  "description": "string",
  "id": null,
  "success": true
}

{
  "code": 0,
  "name": null,
  "description": "string",
  "success": false
}

{
  "code": 0,
  "name": null,
  "description": "string",
  "success": false
}

{
  "code": 0,
  "name": null,
  "description": "string",
  "success": false
}

{
  "code": 0,
  "name": null,
  "description": "string",
  "success": false
}

{
  "code": 0,
  "name": null,
  "description": "string",
  "success": false
}

{
  "code": 0,
  "name": null,
  "description": "string",
  "success": false
}

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

409application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`