Sign in
latestOpenAPI 3.0.32026-08-227451,2751.8 MB

d0fc0114da66

WorkspaceIntegration

Update Workspace Integration

Update Workspace Integration

put/integrations/{id}

Path parameters

idstring required

Workspace Integrations identifier

Headers

If-Matchstring

If-Match header according to http/1.1 spec section 14.24

Request body

idstring

unique identifier

namestring

Human-friendly integration descriptor

integration_type'atlassian_connect' | 'atlassian_rovo' | 'export_feed_google_bigquery' | 'export_feed_google_cloud_storage' | 'export_feed_google_pubsub' | 'github_app' | 'jira' | 'jira_server_plugin' | 'microsoft_teams_webhook' | 'segment' | 'slack' | 'xray' | 'xray_sync'
integration_categoriesstring[]
installation_idstring

a unique id that identifies this integration in the third party service, if applicable

claim_expiration_secondsinteger

length of time until this integration expires, if left unclaimed. Leaving this empty means there is no expiry.

workspace_idstring

Associated workspace

enabledboolean

Disable to stop running integration

encrypted_storestring

Encryption store to use for sensitive data

status'success' | 'error' | 'pending'

Last known integration state

created_timeinteger

Time at which the insight was created

created_by_idstring

The ID of the user who created this insight

last_updated_timeinteger

time the insight was last updated

last_updated_by_idstring

The ID of the user who last updated this insight

Example request

{
  "config": {
    "issue_tracker": {
      "base_url": "https://jira.example.com/jira",
      "schemas": [
        {
          "fields": [
            {
              "id": "affected_platform",
              "name": "Affected Platform",
              "type": "labels",
              "allowed_values": [
                {
                  "value": "Chrome"
                },
                {
                  "value": "Edge"
                },
                {
                  "value": "Firefox"
                },
                {
                  "value": "IE11"
                },
                {
                  "value": "Safari"
                }
              ],
              "is_required": true
            }
          ]
        }
      ]
    }
  }
}

Response

Updated Workspace Integration

idstring

unique identifier

namestring

Human-friendly integration descriptor

integration_type'atlassian_connect' | 'atlassian_rovo' | 'export_feed_google_bigquery' | 'export_feed_google_cloud_storage' | 'export_feed_google_pubsub' | 'github_app' | 'jira' | 'jira_server_plugin' | 'microsoft_teams_webhook' | 'segment' | 'slack' | 'xray' | 'xray_sync'
integration_categoriesstring[]
installation_idstring

a unique id that identifies this integration in the third party service, if applicable

claim_expiration_secondsinteger

length of time until this integration expires, if left unclaimed. Leaving this empty means there is no expiry.

workspace_idstring

Associated workspace

enabledboolean

Disable to stop running integration

encrypted_storestring

Encryption store to use for sensitive data

status'success' | 'error' | 'pending'

Last known integration state

created_timeinteger

Time at which the insight was created

created_by_idstring

The ID of the user who created this insight

last_updated_timeinteger

time the insight was last updated

last_updated_by_idstring

The ID of the user who last updated this insight

Example response

{
  "config": {
    "issue_tracker": {
      "base_url": "https://jira.example.com/jira",
      "schemas": [
        {
          "fields": [
            {
              "id": "affected_platform",
              "name": "Affected Platform",
              "type": "labels",
              "allowed_values": [
                {
                  "value": "Chrome"
                },
                {
                  "value": "Edge"
                },
                {
                  "value": "Firefox"
                },
                {
                  "value": "IE11"
                },
                {
                  "value": "Safari"
                }
              ],
              "is_required": true
            }
          ]
        }
      ]
    }
  }
}