Skip to main content
POST
/
search
/
files
Search files with advanced filters.
curl --request POST \
  --url https://api.smokeball.com/search/files \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json-patch+json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "query": "contract",
  "filters": {
    "searchFields": [
      "Name",
      "Content"
    ],
    "includeFileExtensions": [
      "pdf",
      "docx"
    ],
    "excludeFileExtensions": [
      "tmp",
      "bak"
    ],
    "authorIds": [
      "750eb5c5-ac0b-7d11-4997-e0ce9d8896c8"
    ],
    "contactIds": [
      "b471682e-fa17-4e46-b7fe-9b2b8fdcb3c2"
    ]
  }
}
'
[
  "<unknown>"
]

Documentation Index

Fetch the complete documentation index at: https://docs.smokeball.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

ā€‹
x-api-key
string
header
required
ā€‹
Authorization
string
header
required

Query Parameters

ā€‹
Offset
integer<int32>
Required range: 0 <= x <= 2147483647
ā€‹
Limit
integer<int32>
Required range: 1 <= x <= 500

Body

ā€‹
query
string
required

Full-text search expression. Required and non-empty.

Minimum string length: 1
Example:

"contract"

ā€‹
filters
object

Filters narrowing the search to specific extensions, date ranges, authors, contacts, and which fields to match against.

Response

Returns the matching files.