Documentation Index

Fetch the complete documentation index at: https://developers.torq.io/llms.txt

Use this file to discover all available pages before exploring further.

Create guidance

Prev Next
Post
/v1/triage/guidance

Creates a new guidance entry. Guidance provides a business context that informs Auto Triage reasoning during alert triage. For more information, refer to our Guidance documentation.

Security
HTTP
Type bearer
Body parameters
Expand All
object
name
string

The guidance name. Maximum 200 characters. This property is required.

Min length1
Max length200
description
string

An optional description of the guidance. Maximum 2,000 characters.

Max length2000
guidance
string

The guidance text provided to Auto Triage during alert triage. Maximum 2,000 characters. This property is required.

Min length1
Max length2000
enabled
boolean

Indicates whether the guidance is active. Defaults to true.

apply
object (torq.public.triage.v1.Apply)

Defines which alerts this applies to.

type
string

The scope of alerts this applies to. Accepted values: "always", "by_source", "by_categories".

Valid values[ "always", "by_source", "by_categories" ]
categories
Array of string

The security categories to match. Required when type is "by_categories".

string
integration_type_ids
Array of string

The alert source type IDs to match. Required when type is "by_source".

string
Responses
200

A successful response.

Expand All
object
guidance
object (torq.public.triage.v1.Guidance)

Guidance provides business context that informs Auto Triage reasoning during alert triage. Each entry defines instructions or policies scoped to specific alerts, helping Auto Triage produce more accurate triage verdicts.

id
string

The unique identifier of the guidance entry.

name
string

The guidance name. Maximum 200 characters.

description
string

An optional description of the guidance.

guidance
string

The instruction text provided to Auto Triage during alert triage.

enabled
boolean

Whether the guidance is currently active.

apply
object (torq.public.triage.v1.Apply)

Defines which alerts this applies to.

type
string

The scope of alerts this applies to. Accepted values: "always", "by_source", "by_categories".

Valid values[ "always", "by_source", "by_categories" ]
categories
Array of string

The security categories to match. Required when type is "by_categories".

string
integration_type_ids
Array of string

The alert source type IDs to match. Required when type is "by_source".

string
created_at
string (date-time)

The timestamp when the guidance was created.

updated_at
string (date-time)

The timestamp when the guidance was last updated.

401

Invalid bearer token. If you receive this message more than once try creating a new Client ID/Client Secret or generating a new bearer token.

object
403

You don't have permission to access this resource.

object