---
title: "Linear Issues Search"
method: POST
path: "/api/linear/issues/search"
tags: ["linear"]
---

# Linear Issues Search

`POST /api/linear/issues/search`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/linear/issues/search`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

linear.issues.search: one bounded page of issues.

The GraphQL ``IssueFilter`` is composed server-side from the typed fields;
a caller never supplies a raw filter object, so a crafted request cannot
turn a bounded search into an unbounded scan.

## Request body

- LinearIssuesSearchPayload
  - `cursor` string, nullable
  - `limit` integer
  - `query` string, nullable
  - `state` string, nullable
  - `team` string, nullable

## Response `200`

Successful Response

- LinearIssuePageResponse
  - `connection_mode` 'workspace', required
  - `has_more` boolean, required
  - `issues` LinearIssue[], required
    - `assignee` LinearNamedEntity: Stable named-object projection shared by teams, states, and actors.
      - `email` string, nullable
      - `id` string, nullable
      - `key` string, nullable
      - `name` string, nullable
      - `type` string, nullable
    - `created_at` string, nullable
    - `creator` LinearNamedEntity: Stable named-object projection shared by teams, states, and actors.
      - `email` string, nullable
      - `id` string, nullable
      - `key` string, nullable
      - `name` string, nullable
      - `type` string, nullable
    - `description` string, nullable
    - `identifier` string, nullable
    - `issue_id` string, nullable
    - `priority` integer, nullable
    - `state` LinearNamedEntity: Stable named-object projection shared by teams, states, and actors.
      - `email` string, nullable
      - `id` string, nullable
      - `key` string, nullable
      - `name` string, nullable
      - `type` string, nullable
    - `team` LinearNamedEntity: Stable named-object projection shared by teams, states, and actors.
      - `email` string, nullable
      - `id` string, nullable
      - `key` string, nullable
      - `name` string, nullable
      - `type` string, nullable
    - `title` string, nullable
    - `updated_at` string, nullable
    - `url` string, nullable
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)