> For the complete documentation index, see [llms.txt](https://docs.ox.security/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ox.security/api-documentation/api-reference/api--cicd-issue/types/inputs/cicd-issues-input.md).

# cicdIssuesInput

Defines the input parameters for querying CI/CD issues.

### Examples

```graphql
input CICDIssuesInput {
  search: [AutoCompleteSearch]
  scanID: String
  limit: Int!
  offset: Int!
  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                                   |                                                                                                                                                                                                                                                                                                                                                                               |
| 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="/api-documentation/api-reference/api--cicd-issue/types/enums/cicd-issue-sort-by-fields.md"><code>\[CICDIssueSortByFields]</code></a><br>order <a href="/api-documentation/api-reference/api--audit/types/enums/direction.md"><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="/api-documentation/api-reference/api--application/types/enums/condition-type.md"><code>ConditionType</code></a><br>fieldName <a href="/api-documentation/api-reference/api--application/types/enums/filter-types.md"><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)
* [\<?> getCICDIssuesConditionalFilters.getCICDIssuesInput](/api-documentation/api-reference/api--cicd-issue/queries/get-cicd-issues-conditional-filters.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.