Skip to main content
POST
/
transforms
/
search
Search transforms (POST)
curl --request POST \
  --url https://api.streamkap.com/transforms/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": [
    "<string>"
  ],
  "tag_ids": [
    "<string>"
  ],
  "tag_filter_operation": "and"
}
'
{}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
id
string | null
​
partial_name
string | null
​
page
integer
default:1
​
page_size
integer
default:10
​
sort
string | null

Sort field. Can be DB field (name, created_timestamp) or metric (status, latency, duration)

​
sort_dir
enum<string>
default:asc

Sort direction: 'asc' or 'desc'

Available options:
asc,
desc
​
status
string | null

Filter by status. Comma-separated for multiple (e.g., 'RUNNING', 'RUNNING,STOPPED'). Valid statuses: RUNNING, INITIALIZING, DEPLOYING, CANCELLING, CANCELED, CREATED, RESTARTING, FAILING, FAILED, STOPPED, UNKNOWN

​
latency
string | null

Filter by latency in milliseconds. Format: 'operator:value' (e.g., 'gt:1000', 'lt:500'). Valid operators: gt (>), lt (<), gte (>=), lte (<=), eq (=), ne (!=)

​
duration
string | null

Filter by duration in milliseconds. Format: 'operator:value' (e.g., 'gt:5000', 'lt:1000'). Valid operators: gt (>), lt (<), gte (>=), lte (<=), eq (=), ne (!=)

​
unwind_topics
boolean
default:false

Unwind topics into separate rows (one per topic). Default is False (topics returned as array in each transform row). Note: Pagination with unwind_topics=true may not reflect accurate totals.

​
tag_ids
string | null

Filter by tag IDs. Comma-separated list (e.g., 'tag1,tag2'). Use with tag_filter_operation to control AND/OR logic.

​
tag_filter_operation
enum<string> | null
default:or

Tag filter logic: 'or' (default) matches any tag, 'and' matches all tags.

Available options:
and,
or

Body

application/json

Body model for POST /transforms/search requests.

Supports large lists of filter values that would exceed URL length limits when using GET. Body parameters take precedence over query parameters when both are provided.

​
status

List of statuses (as array) or comma-separated string. Body takes precedence over query params.

​
tag_ids

List of tag IDs (as array) or comma-separated string. Body takes precedence over query params.

​
tag_filter_operation
enum<string> | null

Tag filter logic: 'or' (default) matches any tag, 'and' matches all tags. Body takes precedence over query params.

Available options:
and,
or

Response

Successful Response

The response is of type FullTransformsRes · object.