---
title: "List the projects an issue tracker integration reads references from"
method: GET
path: "/issueTrackers/integrations/{workspace_integration_id}/projects"
tags: ["TrackerItem"]
---

# List the projects an issue tracker integration reads references from

`GET /issueTrackers/integrations/{workspace_integration_id}/projects`

## Request

- Base URL: `https://api.mabl.com`
- URL: `https://api.mabl.com/issueTrackers/integrations/{workspace_integration_id}/projects`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

The projects a reference picker may search. One entry for a tracker whose integration is a single project; for Jira, the configured projects, resolved live. The workspace is taken from the stored integration.

## Path parameters

- `workspace_integration_id` string, required

## Response `200`

The integration's projects

- TrackerProjectList
  - `projects` TrackerProject[], required
    - `id` string, required: What search takes as project_id
    - `key` string: The short prefix the tracker writes on an item key, when it has one
    - `name` string, required

## Other responses

- `400`: Invalid or missing parameter
- `401`: User not authenticated
- `402`: Unknown error
- `403`: User not authorized
- `404`: Entity not found
- `429`: Unknown error
- `default`: Unknown error

## Changes

- **2026-10-19** `b602223aa51f`: 7 info
  - added the optional property `guardrail/allOf[#/components/schemas/GuardrailRefusal]/approval` to the response with the `400` status
  - added the optional property `guardrail/allOf[#/components/schemas/GuardrailRefusal]/approval` to the response with the `401` status
  - added the optional property `guardrail/allOf[#/components/schemas/GuardrailRefusal]/approval` to the response with the `402` status
  - added the optional property `guardrail/allOf[#/components/schemas/GuardrailRefusal]/approval` to the response with the `403` status
  - …3 more
- **2026-10-16** `ea5e6f26b08d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mabl/apis/mabl-api/changes/issueTrackers/integrations/:workspace_integration_id/projects/get.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/b602223aa51f?raw)
