Integrations

Update integration settings

Updates settings for the Linear, Jira or Slack integration. For Linear and Jira, set issue_label_enabled and issue_label_name to add a label to each issue that Strix creates. For Slack, any channel id set on slack_default_channel_id or slack_channel_groups must be one Strix can post to: public channels are joined automatically, private channels need @Strix invited first. Personal tokens must belong to an organization administrator (parity with the dashboard).

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",
  "auto_sync_sources": [
    "scan"
  ],
  "auto_sync_reachability": "all",
  "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.

Scopes

integrations:write

Path Parameters

provider

enum<string>

required

Integration provider.

Available options:

linear,

jira,

slack

Body

application/json

Option 1
Option 2

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

auto_sync_sources

enum<string>[]

Finding sources that auto-sync creates tickets for (at least one): scan (pentest findings) and/or supply_chain (dependency CVEs). Set auto_sync_enabled to false to stop all auto-sync. Manual, bulk, and API pushes ignore this.

Minimum array length: 1

Available options:

scan,

supply_chain

auto_sync_reachability

enum<string>

Which dependency findings auto-create tickets. all (the default) tickets every dependency finding; reachable_only tickets only the findings whose reachability verdict is reachable; findings marked not_reachable or not_applicable, and findings still waiting for a verdict, get no ticket. Pentest findings ignore this. Manual, bulk, and API pushes ignore this.

Available options:

all,

reachable_only

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 integration settings (Linear, Jira) or {"success": true} (Slack).

Option 1
Option 2

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

auto_sync_sources

enum<string>[]

required

Finding sources that auto-sync creates tickets for: scan (pentest findings) and supply_chain (dependency CVEs). PR-review findings never auto-sync. Manual, bulk, and API pushes ignore this.

Minimum array length: 1

Available options:

scan,

supply_chain

auto_sync_reachability

enum<string>

required

Which dependency findings auto-create tickets. all (the default) tickets every dependency finding; reachable_only tickets only the findings whose vulnerable code the scan proved runs. Pentest findings ignore this.

Available options:

all,

reachable_only

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",
  "auto_sync_sources": [
    "scan"
  ],
  "auto_sync_reachability": "all",
  "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>"
}

Domains

Analytics

Asset Discovery

Audit

Billing

Chat

CLI

Connectors

Containers

Assets

Test Users

Integrations

Knowledge

License

LLM

Run Logs

Organization

Invitations

Members

PR Reviews

Vulnerabilities

Repositories

Supply Chain

Scans

Schedules

Search

Tokens

Uploads

Webhooks

Workspaces

Update integration settings

Authorizations

Scopes

Path Parameters

Body

Response