# Create Saved Report

A saved report contains information about the report, such as its name and permissions, and also the Grid API query definition that is applied when users view the report. The query definition uses the same JSON format as a Grid API request

Endpoint: POST /v3/reports/grid/saved
Security: API_Key

## Request fields (application/json):

  - `name` (string, required)
    Name of the saved report

  - `isFavorite` (boolean)
    Indicates if the saved report is marked as favorite by the current user

  - `visibility` (string, required)
    Enum: "private", "public"

  - `queryDefinition` (object, required)
    Default Grid request body properties.
Default behaviour:
- if no page number is specified, default is 0 (the first results page)
- if no size is specified, default is 100
- if no filters are specified, default is to return all runs
Default behaviour for exports:
- if page and size are not specified, all available rows will be exported

  - `queryDefinition.size` (integer)
    how many rows to include in the paginated response

  - `queryDefinition.page` (integer)
    paginated response page number, starts with 0

  - `queryDefinition.filters` (object)

  - `queryDefinition.filters.conditions` (array)

  - `queryDefinition.filters.conditions.negated` (boolean)
    If true, the filter will match entities where the value does not match

  - `queryDefinition.filters.conditions.operator` (string, required)
    Enum: "string_contains", "string_contains_multi", "string_regex", "integer_in", "integer_list_contains", "number_between", "date_time_between", "date_time_relative", "is_present", "metric_alert_any"

  - `queryDefinition.filters.conditions.filteredColumn` (any, required)

  - `queryDefinition.filters.conditionMatchMode` (string)
    Specifies how to combine results of multiple conditions when determining if a row should be included in the result:
-  - all conditions must be met;
-  - at least one condition must be met.
Default is .
    Enum: "all", "any"

  - `queryDefinition.columns` (array)

  - `queryDefinition.sortBy` (array)
    Sorts the result by the specified columns, in the same order as in the columns array.

  - `queryDefinition.sortBy.columnIndex` (integer, required)
    Index of the column in the columns array

  - `queryDefinition.sortBy.sortDesc` (boolean)
    If true, the column will be sorted in descending order. Default is ascending

  - `gridEntityType` (string, required)
    Enum: "web_audit_runs", "web_journey_runs", "pages", "cookies", "tags", "tag_variables", "links", "accessibility_issues", "network_requests"

  - `displayMetadata` (object)
    Display metadata for the saved report

## Response 201 fields (application/json):

  - `id` (integer, required)
    ID of the saved report

## Response 400 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 401 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 403 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)