Search transforms (POST)

POST alternative for GET /transforms. Use when URL length limits are exceeded (e.g., 100+ tag IDs). Supports both query parameters and request body. Body parameters take precedence over query parameters.

POST/transforms/search

Authorization

AuthorizationBearer token · headerrequired

Query parameters

idstring | any

partial_namestring | any

pageinteger

default: 1

page_sizeinteger

default: 10

sortstring | any

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

sort_dirstring

Sort direction: 'asc' or 'desc'

default: "asc"

Allowed:ascdesc

statusstring | any

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

latencystring | any

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

durationstring | any

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

unwind_topicsboolean

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.

default: false

tag_idsstring | any

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

tag_filter_operationstring | any

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

default: "or"

Request body

application/json

Any of:

TransformDetailsReqBody

statusstring[] | string | any

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

Show properties

Any of:

string[]

Array of string

string

string

string

any

any

tag_idsstring[] | string | any

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

Show properties

Any of:

string[]

Array of string

string

string

string

any

any

tag_filter_operationstring | any

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

Show properties

Any of:

string

string

any

any

any

any

Responses

200

Successful Response

object

422

Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

Request

curl -X POST "https://api.streamkap.com/transforms/search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "status": [
    "string"
  ],
  "tag_ids": [
    "string"
  ],
  "tag_filter_operation": "and"
}'

const response = await fetch("https://api.streamkap.com/transforms/search", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"status\": [\n    \"string\"\n  ],\n  \"tag_ids\": [\n    \"string\"\n  ],\n  \"tag_filter_operation\": \"and\"\n}"
});

import requests

response = requests.post(
    "https://api.streamkap.com/transforms/search",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"status\": [\n    \"string\"\n  ],\n  \"tag_ids\": [\n    \"string\"\n  ],\n  \"tag_filter_operation\": \"and\"\n}",
)

Response

{}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}