---
title: "Resolve a pasted tracker item id or link against the workspace's tracker integrations"
method: POST
path: "/issueTrackers/workspaces/{workspace_id}/items:lookup"
tags: ["TrackerItem"]
---

# Resolve a pasted tracker item id or link against the workspace's tracker integrations

`POST /issueTrackers/workspaces/{workspace_id}/items:lookup`

Resolves 123, AB#123 or a work item URL. Never picks an integration for the caller: a supplied workspace_integration_id is the only one asked; a URL resolves only in the organization and project it names; an id found in more than one integration is ambiguous, with every match as a candidate; and when any integration could not be asked the result is ambiguous_or_unavailable rather than found. TestRail and Jira links are other_platform, without contacting any tracker.

## Path parameters

- `workspace_id` string, required

## Request body

- TrackerItemLookupRequest
  - `input` string, required — 123, AB#123 or a work item URL
  - `workspace_integration_id` string — Resolve only against this integration. Validated against the workspace.

## Response `200`

The resolution and its candidates

- TrackerItemLookupResult
  - `status` 'found' | 'ambiguous' | 'ambiguous_or_unavailable' | 'not_found' | 'not_connected' | 'other_platform' | 'unrecognised', required — found: exactly one integration holds the item (the one candidate). ambiguous: several do; every match is a candidate and the caller must choose. ambiguous_or_unavailable: at least one integration could not be asked, so a match is never reported as unique. not_found: every integration asked answered, and none holds it in its project. not_connected: no enabled integration covers the organization and project the input names. other_platform: a TestRail or Jira link, not a tracker item. unrecognised: not an item id or link.
  - `candidates` TrackerItemSummary[], required — Exactly one when found
    - `platform` 'azure_boards', required — The issue tracker an item lives in.
    - `workspace_integration_id` string, required — The integration whose project holds this item
    - `issue_key` string, required — The canonical key sent upstream
    - `display_key` string, required — The key as the tracker writes it
    - `title` string, required
    - `item_type` string
    - `state` string
    - `url` string — The item in the tracker, for a human following up

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `402` — Unknown error
- `403` — User not authorized
- `429` — Unknown error
- `default` — Unknown error

## Changes

- **2026-09-26** `e0444c72fafc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mabl/apis/mabl-api/changes/issueTrackers/workspaces/:workspace_id/items:lookup/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)