Update ticketing integration settings

PATCH

integrations

{provider}

settings

Error

A valid request URL is required to generate request examples

{
  "id": "<string>",
  "provider": "linear",
  "status": "<string>",
  "status_detail": "<string>",
  "auto_sync_enabled": true,
  "issue_label_enabled": true,
  "issue_label_name": "<string>",
  "auto_sync_min_severity": "critical",
  "default_collection_id": "<string>",
  "default_collection_name": "<string>",
  "default_ticket_type": "<string>",
  "jira_field_values": {},
  "created_at": "2023-11-07T05:31:56Z",
  "source_routes": {
    "scan": {
      "collection_id": "<string>",
      "collection_name": "<string>",
      "ticket_type": "<string>",
      "jira_field_values": {}
    },
    "pr_review": {
      "collection_id": "<string>",
      "collection_name": "<string>",
      "ticket_type": "<string>",
      "jira_field_values": {}
    },
    "supply_chain": {
      "collection_id": "<string>",
      "collection_name": "<string>",
      "ticket_type": "<string>",
      "jira_field_values": {}
    }
  },
  "default_assignee_id": "<string>",
  "default_assignee_name": "<string>",
  "title_template": "<string>",
  "description_template": "<string>",
  "group_by_pentest": true,
  "jira_priority_map": {},
  "due_date_days": {},
  "repositories": [
    {
      "id": "<string>",
      "full_name": "<string>",
      "provider": "<string>"
    }
  ],
  "repository_routes": [
    {
      "collection_id": "<string>",
      "repository_id": "<string>",
      "collection_name": "<string>",
      "ticket_type": "<string>",
      "jira_field_values": {},
      "project_id": "<string>",
      "project_name": "<string>"
    }
  ]
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

Authorizations

Authorization

string

header

required

API token obtained from the Tokens endpoint or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.

Path Parameters

provider

enum<string>

required

Ticketing integration provider.

Available options:

linear,

jira

Body

application/json

Updates for a Linear or Jira integration.

auto_sync_enabled

boolean

Enable automatic issue creation for new findings.

issue_label_enabled

boolean

Add the configured label to each issue that Strix creates.

issue_label_name

string

Label name to add to each issue that Strix creates.

Required string length: 1 - 80

auto_sync_min_severity

enum<string>

Minimum severity that triggers automatic issue creation.

Available options:

critical,

high,

medium,

low

default_collection_id

string | null

Default Jira project or Linear team identifier.

default_collection_name

string | null

Default Jira project or Linear team name.

default_ticket_type

string | null

Default Jira issue type.

jira_field_values

object

Jira required field values for the default project.

repository_routes

object[]

Destination for each routed repository. Applies to Linear and Jira. This array replaces the stored repository routes: a repository that is not in the array loses its route. Send collection_id (the older project_id name is still accepted). For Jira, ticket_type and jira_field_values are optional and Strix rejects a route that misses a required field. Administrators only.

Option 1
Option 2

Show child attributes

source_routes

object

The destination for each finding source, keyed by scan (pentests), pr_review, and supply_chain. Applies to Linear and Jira. This object replaces the stored routes. To use the default destination for a source, set the key to null or leave the key out. Resolution order on a push: explicit destination on the push request, then repository route, then source route, then the default destination.

Show child attributes

default_assignee_id

string | null

Provider user ID for the default assignee (see GET /integrations/{provider}/users). Strix checks the user with the provider. Set null to clear.

title_template

string | null

Ticket title template. Unknown placeholders are rejected. Set null to use {{title}}.

Maximum string length: 500

description_template

string | null

Ticket description template. Unknown placeholders are rejected. Set null to use {{details}}.

Maximum string length: 20000

group_by_pentest

boolean

Create one Linear project or Jira Epic per pentest and file its tickets under it.

jira_priority_map

object | null

Jira only. Maps severities (critical, high, medium, low) to { id } (the Jira priority ID, from GET /integrations/{provider}/priorities) or null. Send null to disable. Rejected for Linear. Administrators only.

due_date_days

object | null

Maps severities to a whole number of days (1-365) after creation for the due date, or null per severity. Send null to disable. Applies to Linear and Jira; new tickets only. Administrators only.

Response

Updated ticketing integration settings.

Ticketing settings for a Linear or Jira integration.

string

required

provider

enum<string>

required

Available options:

linear,

jira

status

string

required

status_detail

string | null

required

auto_sync_enabled

boolean

required

issue_label_enabled

boolean

required

issue_label_name

string

required

auto_sync_min_severity

enum<string>

required

Available options:

critical,

high,

medium,

low

default_collection_id

string | null

required

default_collection_name

string | null

required

default_ticket_type

string | null

required

jira_field_values

object

required

created_at

string<date-time> | null

required

source_routes

object

The destination for each finding source, keyed by scan (pentests), pr_review, and supply_chain. Applies to Linear and Jira. If a key is missing, Strix uses the default destination for that source. A repository route has priority over a source route.

Show child attributes

default_assignee_id

string | null

Provider user ID that new tickets are assigned to. Linear: user ID. Jira Cloud: accountId. Jira Server: username. null leaves tickets unassigned.

default_assignee_name

string | null

Display name of the default assignee.

title_template

string | null

Template for the ticket title. Placeholders use {{name}}: title, severity, cve, cvss, target, endpoint, repository, pentest, source, strix_url, details. null means {{title}}.

description_template

string | null

Template for the ticket description. Same placeholders as title_template. null means {{details}}.

group_by_pentest

boolean

When true, Strix creates one grouping object per pentest and files its tickets under it: a Linear project in the destination team, or a Jira Epic in the destination project.

jira_priority_map

object | null

Jira only: maps each severity (critical, high, medium, low) to a Jira priority { id, name } or null (Jira's default). null disables the mapping; Linear priority always follows severity.

due_date_days

object | null

Maps each severity to a whole number of days (1-365) after ticket creation for the due date, or null (no due date). null disables. Applies to Linear and Jira; a snooze date always wins.

repositories

object[]

Connected repositories that a repository route can target. Present for administrators and service tokens.

Show child attributes

repository_routes

object[]

Ticket destination for each routed repository. Present for administrators and service tokens.

Show child attributes

Error

A valid request URL is required to generate request examples

{
  "id": "<string>",
  "provider": "linear",
  "status": "<string>",
  "status_detail": "<string>",
  "auto_sync_enabled": true,
  "issue_label_enabled": true,
  "issue_label_name": "<string>",
  "auto_sync_min_severity": "critical",
  "default_collection_id": "<string>",
  "default_collection_name": "<string>",
  "default_ticket_type": "<string>",
  "jira_field_values": {},
  "created_at": "2023-11-07T05:31:56Z",
  "source_routes": {
    "scan": {
      "collection_id": "<string>",
      "collection_name": "<string>",
      "ticket_type": "<string>",
      "jira_field_values": {}
    },
    "pr_review": {
      "collection_id": "<string>",
      "collection_name": "<string>",
      "ticket_type": "<string>",
      "jira_field_values": {}
    },
    "supply_chain": {
      "collection_id": "<string>",
      "collection_name": "<string>",
      "ticket_type": "<string>",
      "jira_field_values": {}
    }
  },
  "default_assignee_id": "<string>",
  "default_assignee_name": "<string>",
  "title_template": "<string>",
  "description_template": "<string>",
  "group_by_pentest": true,
  "jira_priority_map": {},
  "due_date_days": {},
  "repositories": [
    {
      "id": "<string>",
      "full_name": "<string>",
      "provider": "<string>"
    }
  ],
  "repository_routes": [
    {
      "collection_id": "<string>",
      "repository_id": "<string>",
      "collection_name": "<string>",
      "ticket_type": "<string>",
      "jira_field_values": {},
      "project_id": "<string>",
      "project_name": "<string>"
    }
  ]
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

Analytics

Asset Discovery

Audit

Billing

Chat

CLI

Connectors

Containers

Assets

Test Users

Integrations

Knowledge

License

LLM

Run Logs

Organization

Invitations

Members

PR Reviews

Vulnerabilities

Supply Chain

Scans

Schedules

Search

Tokens

Uploads

Webhooks

Workspaces

Repositories

Update ticketing integration settings

Authorizations

Path Parameters

Body

Response