---
title: "Poll one Azure Boards integration's work items and mirror their state onto mabl issues"
method: POST
path: "/cron/azureBoards/integrations/{integration_id}/pollIssueStatus"
tags: ["WorkspaceIntegration"]
---

# Poll one Azure Boards integration's work items and mirror their state onto mabl issues

`POST /cron/azureBoards/integrations/{integration_id}/pollIssueStatus`

Called by the azure-boards-status-poll Cloud Tasks queue, not by mabl clients. Requires the CloudSchedulerAuthorizationFilter header and a Google OIDC token for the queue's service account with api-internal as the audience. Bounded by a hard deadline and leased per integration, so overlapping deliveries do not both run. Answers 503 on a transient Azure DevOps failure so the task is retried.

## Path parameters

- `integration_id` string, required

## Response `200`

The run finished, or was skipped

- AzureBoardsStatusPollResult
  - `integration_id` string
  - `outcome` 'completed' | 'stopped_early' | 'not_polled' | 'leased' | 'cooling_down' | 'throttled' | 'reconnect_required' — How the run ended
  - `issues_observed` integer — Issues whose work item Azure returned
  - `issues_written` integer — Issues whose state changed
  - `issues_unobservable` integer — Issues whose work item Azure did not return and the recycle bin did not hold
  - `issues_deferred` integer — Issues whose work item Azure did not return, past this run's recycle-bin cap
  - `cases_marked` integer — Linked Azure Test Cases this run marked Automated or renamed
  - `cases_unmarked` integer — Azure Test Cases this run cleared mabl's automation marker from
  - `cases_skipped` integer — Azure Test Cases this run left unchanged for a reason worth reporting

## Other responses

- `401` — User not authenticated
- `default` — Unknown error

## Changes

- **2026-10-03** `09076d803fdf` — 3 info
  - added the optional property `cases_marked` to the response with the `200` status
  - added the optional property `cases_skipped` to the response with the `200` status
  - added the optional property `cases_unmarked` to the response with the `200` status
- **2026-09-30** `2f721a0018bf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mabl/apis/mabl-api/changes/cron/azureBoards/integrations/:integration_id/pollIssueStatus/post.md)

---

[API](https://skmtc.dev/mabl/apis/mabl-api.md) · [All operations](https://skmtc.dev/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mabl/apis/mabl-api/revisions/24dd8c2933df?raw)
