Clearly AIDocs
Integrations

Azure DevOps Work Items

Connect Clearly AI to Azure DevOps Work Items.

Connect Azure DevOps Work Items so Clearly AI can read work items as Project sources and use work items in Workflows.

Azure DevOps Work Items is separate from Azure Repos. Use this page for tickets. Use Azure Repos for code repositories.

What the integration does

Clearly AI can:

  • Fetch work item title, description, state, assignee, tags, comments, related work items, and attachments.
  • Add comments to work items.
  • Create work items.
  • Assign or unassign work items.
  • Add or remove tags.
  • Attach Review exports to work items.
  • Trigger Workflows when work items are created or updated.

Create the PAT from an Azure DevOps user or service account that can access the projects and work items Clearly AI should use. Use a dedicated service account for shared connections or production Workflows.

Create an Azure DevOps token

  1. In Azure DevOps, open User settings -> Personal access tokens.
  2. Click New Token.
  3. Choose the organization Clearly AI should access.
  4. Set an expiration date that matches your security policy.
  5. Grant Work Items: Read for source ingestion.
  6. Grant Work Items: Read & Write if Workflows should create, comment on, assign, tag, or attach files to work items.
  7. Create the token and copy it. Azure DevOps shows the token only once.

Connect in Clearly AI

  1. In Clearly AI, open Integrations.
  2. Select Azure DevOps Work Items.
  3. In Organization ID, enter the Azure DevOps organization name from https://dev.azure.com/<organization>.
  4. In Personal Key, paste the PAT.
  5. Save and test the connection.

Add a work item as a source

  1. Open a Project.
  2. Open Manage Sources and click Search Integrations.
  3. Select Azure DevOps Work Items.
  4. Choose the Azure DevOps project.
  5. Enter the work item ID, such as 12345.
  6. Save the source.

Clearly AI fetches the work item and includes it as Project context for Reviews and Chat.

Use work items in Workflows

Azure DevOps Work Item Workflow support includes:

  • ADO Work Item Created or Updated trigger, with optional tags, projects, and states.
  • Create ADO Work Item.
  • Assign ADO Work Item.
  • Create ADO Work Item Comment.
  • Attach Review Export to ADO Work Item.

To use the trigger, configure a Service Hooks > Web Hooks subscription in Azure DevOps for work item events. Use the Clearly AI webhook URL as the target URL. Clearly AI shows the webhook URL and secret after you save the webhook settings. The default secret header name is X-Clearly-Webhook-Secret.

FAQs

Aha! Roadmaps

Connect Clearly AI to Aha! Roadmaps.

Linear

Connect Clearly AI to Linear.