v1

latestOpenAPI 3.0.02026-08-065019221.4 KB
Saved Searches

Create Saved Search

Create a Saved Search.

post/api/v1/user/searches/

Request body

Example request

{
  "search": {
    "datasource": "scans",
    "query": "page.domain:urlscan.io",
    "name": "Testsearch",
    "description": "urlscan documentation example saved search.",
    "longDescription": "Example saved search created from urlscan documentation.",
    "tlp": "red",
    "userTags": [
      "private.privatetag"
    ],
    "permissions": [
      "team:read",
      "team:write"
    ]
  }
}

Response

OK

Example response

{
  "search": {
    "_id": "{{searchId}}",
    "datasource": "scans",
    "query": "page.domain:urlscan.io",
    "name": "Testsearch",
    "description": "urlscan documentation example saved search.",
    "longDescription": "Example saved search created from urlscan documentation",
    "tlp": "red",
    "userTags": [
      "private.privatetag"
    ],
    "permissions": [
      "team:read",
      "team:write"
    ]
  }
}