# cicdIssuesInput

Defines the input parameters for querying CI/CD issues.

### Examples

```graphql
input CICDIssuesInput {
  search: [AutoCompleteSearch]
  scanID: String
  limit: Int!
  offset: Int!
  filters: CICDIssueFilters
  sort: CICDIssuesSort
  owners: [String]
  tagIds: [String]
  inventoryFilters: [InventoryTypes]
  conditionalFilters: [ConditionalFilters]
  openItems: [FilterTypes]
  dateRange: DateRange
  limitAggItems: Int
  offsetAggItems: Int
  topOffset: Int
  issueId: String
  scrollDirection: String
  topLevelSearch: String
}
```

### Fields

| Field                                                                                                                              | Description                                                                             | Supported fields                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| search [`[AutoCompleteSearch]`](/api-documentation/api-reference/api--application/types/inputs/auto-complete-search.md)            | Specifies search criteria for filtering issues                                          | <p>fieldName <code>String</code><br>value <code>\[String]</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| scanID `String`                                                                                                                    | Identifies a specific scan to retrieve issues from                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| limit `Int!`                                                                                                                       | Sets the maximum number of issues to return in the response                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| offset `Int!`                                                                                                                      | Specifies the number of issues to skip for pagination                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ~~filters~~ [~~`CICDIssueFilters`~~](/api-documentation/api-reference/api--cicd-issue/types/inputs/cicd-issue-filters.md) ⚠️       | **Deprecated**: Use conditionalFilters instead, will be removed in Jan 2026             | <p>apps <code>\[String]</code><br>criticality <a href="/pages/Xj3AzMr9UKvGkYsTiOu2"><code>\[CriticalityFilter]</code></a><br>policies <code>\[String]</code><br>issueOwners <code>\[String]</code><br>categories <code>\[String]</code><br>issueNames <code>\[String]</code><br>sourceTools <code>\[String]</code><br>businessPriority <a href="/pages/XJfLZ7TiEldyCBQnkaBu"><code>Range</code></a><br>issueImportance <a href="/pages/XJfLZ7TiEldyCBQnkaBu"><code>Range</code></a><br>appId <code>\[String]</code><br>cwe <code>\[String]</code><br>severityChange <code>\[String]</code><br>severityChangeReasons <code>\[String]</code><br>issueActions <code>\[String]</code><br>jobTriggeredBy <code>\[String]</code><br>cicdIssueStatus <code>\[String]</code><br>jobNumber <code>\[String]</code><br>enforcement <code>\[String]</code><br>pullRequests <code>\[String]</code><br>sourceBranch <code>\[String]</code><br>issueIds <code>\[String]</code></p> |
| sort [`CICDIssuesSort`](/api-documentation/api-reference/api--cicd-issue/types/inputs/cicd-issues-sort.md)                         | Specifies how to sort the returned issues                                               | <p>fields <a href="/pages/Z8U2gibrW1QNHkF3HwD3"><code>\[CICDIssueSortByFields]</code></a><br>order <a href="/pages/MShdjanlfhzp71ZokzYR"><code>\[Direction]</code></a></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| owners `[String]`                                                                                                                  | Filters issues by their assigned owners                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| tagIds `[String]`                                                                                                                  | Filters issues based on RBAC tag scope                                                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| inventoryFilters [`[InventoryTypes]`](/api-documentation/api-reference/api--issue/types/enums/inventory-types.md)                  | Specifies inventory filters for top 5 issues                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| conditionalFilters [`[ConditionalFilters]`](/api-documentation/api-reference/api--application/types/inputs/conditional-filters.md) | Defines conditional filters for advanced issue filtering                                | <p>condition <a href="/pages/pEzh4bUHpgEO9hKwuQuZ"><code>ConditionType</code></a><br>fieldName <a href="/pages/43jgm6P5kcKgBM8FmTho"><code>FilterTypes</code></a><br>values <code>\[String]</code><br>greaterThan <code>Float</code><br>lessThan <code>Float</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| openItems [`[FilterTypes]`](/api-documentation/api-reference/api--application/types/enums/filter-types.md)                         | Specifies which filter types are currently open                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| dateRange [`DateRange`](/api-documentation/api-reference/api--application/types/inputs/date-range.md)                              | Defines the date range for filtering top 5 issues                                       | <p>from <code>Float</code><br>to <code>Float</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| limitAggItems `Int`                                                                                                                | Sets the maximum number of aggregation items to return                                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| offsetAggItems `Int`                                                                                                               | Specifies the number of aggregation items to skip                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| topOffset `Int`                                                                                                                    | Defines the top offset for pagination                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| issueId `String`                                                                                                                   | Identifies a specific issue for pagination                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| scrollDirection `String`                                                                                                           | Specifies the direction for scrolling through paginated results                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| topLevelSearch `String`                                                                                                            | Specifies a top-level search term for filtering by Issue Name, CVE, or Application Name |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

### References

#### Queries using this object:

* [\<?> getCICDIssues.getCICDIssuesInput](/api-documentation/api-reference/api--cicd-issue/queries/get-cicd-issues.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ox.security/api-documentation/api-reference/api--cicd-issue/types/inputs/cicd-issues-input.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
