Skip to main content
POST
Error

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.

Body

application/json

Connect a self-hosted Jira (Data Center or Server) with a personal access token.

instance_url
string
required

Base URL of the Jira instance, for example https://jira.example.com or https://tools.example.com/jira.

access_token
string
required

Personal access token that the Jira user created on that instance.

Response

Connected.

success
boolean
required
webhook_registered
boolean
required

True when Strix registered the status webhook on the Jira instance.

webhook_url
string
required

Webhook URL for a Jira administrator to add when webhook_registered is false. The URL contains a secret and is returned once.

webhook_error
string | null

Reason Jira refused the webhook registration, if any.

server_title
string | null
server_version
string | null