Output Destinations

Send a test payload to an unsaved output destination

Deliver an example payload to a configured-but-unsaved output destination so it can be verified before creating it. The send is real and may create a message/incident/issue/case in the destination.

post/api/output-destinations/test

Request

  • Base URL
    https://app.cotool.ai
  • Auth
    HTTP bearer

Request body

outputType'detection' | 'response' | 'acceptance-criteria' | 'threat-intel' | 'threat' | 'hunt-alert' | 'alert-escalation' | 'code-detection-auto-tune' | 'ingest-health' required

The context the destination is configured in

existingDestinationIdstring uuid

Existing destination being edited; used to preserve stored secrets when omitted from the unsaved config

agentNamestring

For the response context on non-webhook destinations: the agent name shown in the message header

Response

Successful response

successtrue required

Whether the test output was delivered

destinationType'webhook' | 'teams' | 'slack' | 'pagerduty' | 'linear' | 'tines' | 'incidentio' required

Type of destination the test was sent to

detailstring

Optional human-readable detail about the delivery (e.g. created issue identifier)

outputUrlstring uri

Direct URL to the created output when the destination provides one

outputLinkLabelstring

Human-readable label for the created output link

Changes

No recorded changes to this operation across all 2 revisions of this API.