Jump to

• Request
• Response
• Examples

Update a Saved Search

patch

/rest/v19/searchResources/{resourceVarName}/{searchId}

Use this endpoint to update the specified saved search.

Request

Path Parameters

• resourceVarName(required): string
  The unique variable name to identify the process.
• searchId(required): number
  The unique id of the search.

Body ()

Root Schema : savedSearchItemUpdateInputModel

Type: object

Show Source

• aggregations: object SavedSearchGroupByModel
• description: string
  Example: This is a dummy description
• fields: array fields
• mongoQuery: object mongoQuery
  Additional Properties Allowed: additionalProperties
• name: string
  Example: savedSearchDummy
• orderBy: array orderBy

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "example":"savedSearchDummy"
        },
        "description":{
            "type":"string",
            "example":"This is a dummy description"
        },
        "fields":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "mongoQuery":{
            "type":"object",
            "additionalProperties":{
            }
        },
        "orderBy":{
            "type":"array",
            "items":{
                "type":"string",
                "example":"_id:desc"
            }
        },
        "aggregations":{
            "$ref":"#/definitions/SavedSearchGroupByModel"
        }
    }
}

Nested Schema : SavedSearchGroupByModel

Type: object

Show Source

• attribute: string
• sort: string
  Default Value: desc

  Allowed Values: [ "asc", "desc" ]

{
    "type":"object",
    "properties":{
        "attribute":{
            "type":"string"
        },
        "sort":{
            "type":"string",
            "enum":[
                "asc",
                "desc"
            ],
            "default":"desc"
        }
    }
}

Nested Schema : fields

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : mongoQuery

Type: object

Additional Properties Allowed

Show Source

{
    "type":"object",
    "additionalProperties":{
    }
}

Nested Schema : orderBy

Type: array

Show Source

• Array of: string
  Example: _id:desc

{
    "type":"array",
    "items":{
        "type":"string",
        "example":"_id:desc"
    }
}

Back to Top

Response

200 Response

Successfully modified the saved search

Body ()

Root Schema : savedSearchItem

Type: object

Show Source

• active: boolean
• aggregations: object SavedSearchGroupByModel
• default: boolean
• deletable: string
• description: string
  Example: This is a dummy description
• fields: array fields
• hidden: boolean
• links: array links
• mongoQuery: object mongoQuery
  Additional Properties Allowed: additionalProperties
• name: string
  Example: savedSearchDummy
• orderBy: array orderBy
• queryUuid: number
• savedSearchNumber: number
• searchType: string
  Allowed Values: [ "_user_defined_search", "_my_quotes_search", "_my_approval_search" ]
• shared: boolean
• siteLevelDefault: boolean
• updatable: boolean
• userId: number
• userKey: string
• userLevelDefault: boolean
• userName: string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "example":"savedSearchDummy"
        },
        "description":{
            "type":"string",
            "example":"This is a dummy description"
        },
        "queryUuid":{
            "type":"number"
        },
        "savedSearchNumber":{
            "type":"number"
        },
        "default":{
            "type":"boolean"
        },
        "updatable":{
            "type":"boolean"
        },
        "userId":{
            "type":"number"
        },
        "userName":{
            "type":"string"
        },
        "fields":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "shared":{
            "type":"boolean"
        },
        "active":{
            "type":"boolean"
        },
        "searchType":{
            "type":"string",
            "enum":[
                "_user_defined_search",
                "_my_quotes_search",
                "_my_approval_search"
            ]
        },
        "mongoQuery":{
            "type":"object",
            "additionalProperties":{
            }
        },
        "orderBy":{
            "type":"array",
            "items":{
                "type":"string",
                "example":"_id:desc"
            }
        },
        "siteLevelDefault":{
            "type":"boolean"
        },
        "userLevelDefault":{
            "type":"boolean"
        },
        "hidden":{
            "type":"boolean"
        },
        "userKey":{
            "type":"string"
        },
        "deletable":{
            "type":"string"
        },
        "aggregations":{
            "$ref":"#/definitions/SavedSearchGroupByModel"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/link"
            }
        }
    }
}

Nested Schema : SavedSearchGroupByModel

Type: object

Show Source

• attribute: string
• sort: string
  Default Value: desc

  Allowed Values: [ "asc", "desc" ]

{
    "type":"object",
    "properties":{
        "attribute":{
            "type":"string"
        },
        "sort":{
            "type":"string",
            "enum":[
                "asc",
                "desc"
            ],
            "default":"desc"
        }
    }
}

Nested Schema : fields

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object reference links
  Title: reference links

  Reference links for the Parent, Self, Children and Related as applicable

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/link"
    }
}

Nested Schema : mongoQuery

Type: object

Additional Properties Allowed

Show Source

{
    "type":"object",
    "additionalProperties":{
    }
}

Nested Schema : orderBy

Type: array

Show Source

• Array of: string
  Example: _id:desc

{
    "type":"array",
    "items":{
        "type":"string",
        "example":"_id:desc"
    }
}

Nested Schema : reference links

Type: object

Title: reference links

Reference links for the Parent, Self, Children and Related as applicable

Show Source

• href: string
  Title: URL to the related object

  URL to the related object
• name: string
• rel: string
  Title: Link Relationship to the current object

  Default Value: self

  Link Relationship to the current object

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "description":"Link Relationship to the current object",
            "title":"Link Relationship to the current object",
            "default":"self"
        },
        "href":{
            "type":"string",
            "description":"URL to the related object",
            "title":"URL to the related object"
        },
        "name":{
            "type":"string"
        }
    },
    "title":"reference links",
    "description":"Reference links for the Parent, Self, Children and Related as applicable"
}

400 Response

If the saved search is a seeded saved search

404 Response

Saved search could not be found

Back to Top

Examples

The following examples show how to update the specified saved search by submitting a PATCH request to the REST resource using cURL. For more information about cURL, see Use cURL.

curl - X PATCH -H "Authorization: Bearer <token>" - H "Content-type: application/json"
https://sitename.oracle.com/rest/v19/searchResources/commerceDocumentsOraclecpqoTransaction/3023270385

Request Body Sample

{
  "name": "Copy of Operators: Date: =",
  "_entity": "Quote",
  "fields": [
    "_id"
  ],
  "mongoQuery": {
    "processManagerDate": {
      "$eq": "2020-01-01T13:45:00-08:00"
    }
  },
  "keywords": [],
  "orderBy": [],
  "aggregations": {}
}

Back to Top