List conditions | Respan Docs

Returns a paginated list of automation conditions for your organization.

Authentication

All endpoints require API key authentication:

$ Authorization: Bearer YOUR_API_KEY

Note: Use your API Key (not JWT token) for all requests. You can find your API keys in the Respan platform under Settings > API Keys.

Query Parameters

Parameter	Type	Description
`page`	integer	Page number for pagination (default: 1)
`page_size`	integer	Number of items per page (default: 20)
`search`	string	Search conditions by name or slug
`condition_type`	string	Filter by condition type (e.g., `"single_log"`)

Examples

Basic List Request

Python

1 url = "https://api.respan.ai/api/conditions/"
2 headers = {
3     "Authorization": "Bearer YOUR_API_KEY"
4 }
5 
6 response = requests.get(url, headers=headers)
7 print(response.json())

cURL

$ curl -X GET "https://api.respan.ai/api/conditions/" \
>   -H "Authorization: Bearer YOUR_API_KEY"

With Pagination

Python

1 params = {
2     "page": 1,
3     "page_size": 10
4 }
5 
6 response = requests.get(url, headers=headers, params=params)
7 print(response.json())

cURL

$ curl -X GET "https://api.respan.ai/api/conditions/?page=1&page_size=10" \
>   -H "Authorization: Bearer YOUR_API_KEY"

Search Conditions

Python

1 params = {
2     "search": "success",
3     "condition_type": "single_log"
4 }
5 
6 response = requests.get(url, headers=headers, params=params)
7 print(response.json())

cURL

$ curl -X GET "https://api.respan.ai/api/conditions/?search=success&condition_type=single_log" \
>   -H "Authorization: Bearer YOUR_API_KEY"

Response

Status: 200 OK

1 {
2   "results": [
3     {
4       "id": "cond-12345",
5       "condition_slug": "success_logs",
6       "name": "Successful Requests",
7       "condition_type": "single_log",
8       "description": "Matches spans with HTTP status code 200",
9       "condition_policy": {
10         "rules": [
11           {
12             "field": "status_code",
13             "operator": "equals",
14             "value": 200
15           }
16         ],
17         "connector": "AND"
18       },
19       "unique_organization_id": "org-abc123",
20       "created_at": "2025-01-15T10:00:00Z",
21       "updated_at": "2025-01-15T10:00:00Z"
22     }
23   ],
24   "count": 1,
25   "next": null,
26   "previous": null,
27   "filters_data": {}
28 }

Response Fields

Condition Object

Field	Type	Description
`id`	string	Unique condition identifier (save this for creating automations)
`name`	string	Display name of the condition
`condition_slug`	string	URL-friendly identifier
`condition_type`	string	Type of condition (`"single_log"`)
`description`	string	Description of the condition
`condition_policy`	object	The condition policy with rules and connector
`unique_organization_id`	string	Organization identifier
`created_at`	string	ISO timestamp of creation
`updated_at`	string	ISO timestamp of last update

Pagination Object

Field	Type	Description
`count`	integer	Total number of conditions
`previous`	string	URL for previous page (null if first page)
`next`	string	URL for next page (null if last page)
`filters_data`	object	Currently applied filters

Note: Save the id field from the response - you’ll need it when creating the automation.

Error Responses

401 Unauthorized

1 {
2   "detail": "Authentication credentials were not provided."
3 }

400 Bad Request

1 {
2   "detail": "Invalid page number"
3 }

Returns a paginated list of automation conditions for your organization. ## Authentication All endpoints require API key authentication: ```bash Authorization: Bearer YOUR_API_KEY ``` **Note:** Use your API Key (not JWT token) for all requests. You can find your API keys in the Respan platform under Settings > API Keys. ## Query Parameters | Parameter | Type | Description | |-----------|------|-------------| | `page` | integer | Page number for pagination (default: 1) | | `page_size` | integer | Number of items per page (default: 20) | | `search` | string | Search conditions by name or slug | | `condition_type` | string | Filter by condition type (e.g., `"single_log"`) | ## Examples ### Basic List Request ```python Python url = "https://api.respan.ai/api/conditions/" headers = { "Authorization": "Bearer YOUR_API_KEY" } response = requests.get(url, headers=headers) print(response.json()) ``` ```bash cURL curl -X GET "https://api.respan.ai/api/conditions/" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### With Pagination ```python Python params = { "page": 1, "page_size": 10 } response = requests.get(url, headers=headers, params=params) print(response.json()) ``` ```bash cURL curl -X GET "https://api.respan.ai/api/conditions/?page=1&page_size=10" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Search Conditions ```python Python params = { "search": "success", "condition_type": "single_log" } response = requests.get(url, headers=headers, params=params) print(response.json()) ``` ```bash cURL curl -X GET "https://api.respan.ai/api/conditions/?search=success&condition_type=single_log" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ## Response **Status: 200 OK** ```json { "results": [ { "id": "cond-12345", "condition_slug": "success_logs", "name": "Successful Requests", "condition_type": "single_log", "description": "Matches spans with HTTP status code 200", "condition_policy": { "rules": [ { "field": "status_code", "operator": "equals", "value": 200 } ], "connector": "AND" }, "unique_organization_id": "org-abc123", "created_at": "2025-01-15T10:00:00Z", "updated_at": "2025-01-15T10:00:00Z" } ], "count": 1, "next": null, "previous": null, "filters_data": {} } ``` ## Response Fields ### Condition Object | Field | Type | Description | |-------|------|-------------| | `id` | string | Unique condition identifier (save this for creating automations) | | `name` | string | Display name of the condition | | `condition_slug` | string | URL-friendly identifier | | `condition_type` | string | Type of condition (`"single_log"`) | | `description` | string | Description of the condition | | `condition_policy` | object | The condition policy with rules and connector | | `unique_organization_id` | string | Organization identifier | | `created_at` | string | ISO timestamp of creation | | `updated_at` | string | ISO timestamp of last update | ### Pagination Object | Field | Type | Description | |-------|------|-------------| | `count` | integer | Total number of conditions | | `previous` | string | URL for previous page (null if first page) | | `next` | string | URL for next page (null if last page) | | `filters_data` | object | Currently applied filters | **Note:** Save the `id` field from the response - you'll need it when creating the automation. ## Error Responses ### 401 Unauthorized ```json { "detail": "Authentication credentials were not provided." } ``` ### 400 Bad Request ```json { "detail": "Invalid page number" } ```

Authentication

AuthorizationBearer

API key authentication. Get your API key from https://platform.respan.ai/platform/api-keys

Response

Successful response for List conditions

resultslist of objects

countinteger

nextstring

previousstring

filters_dataobject

Errors

401

Unauthorized Error

Returns a paginated list of automation conditions for your organization.

Authentication

All endpoints require API key authentication:

$ Authorization: Bearer YOUR_API_KEY

Note: Use your API Key (not JWT token) for all requests. You can find your API keys in the Respan platform under Settings > API Keys.

Query Parameters

Parameter	Type	Description
`page`	integer	Page number for pagination (default: 1)
`page_size`	integer	Number of items per page (default: 20)
`search`	string	Search conditions by name or slug
`condition_type`	string	Filter by condition type (e.g., `"single_log"`)

Examples

Basic List Request

Python

1 url = "https://api.respan.ai/api/conditions/"
2 headers = {
3     "Authorization": "Bearer YOUR_API_KEY"
4 }
5 
6 response = requests.get(url, headers=headers)
7 print(response.json())

cURL

$ curl -X GET "https://api.respan.ai/api/conditions/" \
>   -H "Authorization: Bearer YOUR_API_KEY"

With Pagination

Python

1 params = {
2     "page": 1,
3     "page_size": 10
4 }
5 
6 response = requests.get(url, headers=headers, params=params)
7 print(response.json())

cURL

$ curl -X GET "https://api.respan.ai/api/conditions/?page=1&page_size=10" \
>   -H "Authorization: Bearer YOUR_API_KEY"

Search Conditions

Python

1 params = {
2     "search": "success",
3     "condition_type": "single_log"
4 }
5 
6 response = requests.get(url, headers=headers, params=params)
7 print(response.json())

cURL

$ curl -X GET "https://api.respan.ai/api/conditions/?search=success&condition_type=single_log" \
>   -H "Authorization: Bearer YOUR_API_KEY"

Response

Status: 200 OK

1 {
2   "results": [
3     {
4       "id": "cond-12345",
5       "condition_slug": "success_logs",
6       "name": "Successful Requests",
7       "condition_type": "single_log",
8       "description": "Matches spans with HTTP status code 200",
9       "condition_policy": {
10         "rules": [
11           {
12             "field": "status_code",
13             "operator": "equals",
14             "value": 200
15           }
16         ],
17         "connector": "AND"
18       },
19       "unique_organization_id": "org-abc123",
20       "created_at": "2025-01-15T10:00:00Z",
21       "updated_at": "2025-01-15T10:00:00Z"
22     }
23   ],
24   "count": 1,
25   "next": null,
26   "previous": null,
27   "filters_data": {}
28 }

Response Fields

Condition Object

Field	Type	Description
`id`	string	Unique condition identifier (save this for creating automations)
`name`	string	Display name of the condition
`condition_slug`	string	URL-friendly identifier
`condition_type`	string	Type of condition (`"single_log"`)
`description`	string	Description of the condition
`condition_policy`	object	The condition policy with rules and connector
`unique_organization_id`	string	Organization identifier
`created_at`	string	ISO timestamp of creation
`updated_at`	string	ISO timestamp of last update

Pagination Object

Field	Type	Description
`count`	integer	Total number of conditions
`previous`	string	URL for previous page (null if first page)
`next`	string	URL for next page (null if last page)
`filters_data`	object	Currently applied filters

Note: Save the id field from the response - you’ll need it when creating the automation.

Error Responses

401 Unauthorized

1 {
2   "detail": "Authentication credentials were not provided."
3 }

400 Bad Request

1 {
2   "detail": "Invalid page number"
3 }

1	url = "https://api.respan.ai/api/conditions/"
2	headers = {
3	"Authorization": "Bearer YOUR_API_KEY"
4	}
5
6	response = requests.get(url, headers=headers)
7	print(response.json())

$	curl -X GET "https://api.respan.ai/api/conditions/" \
>	-H "Authorization: Bearer YOUR_API_KEY"

1	params = {
2	"page": 1,
3	"page_size": 10
4	}
5
6	response = requests.get(url, headers=headers, params=params)
7	print(response.json())

1	params = {
2	"search": "success",
3	"condition_type": "single_log"
4	}
5
6	response = requests.get(url, headers=headers, params=params)
7	print(response.json())

1	{
2	"results": [
3	{
4	"id": "cond-12345",
5	"condition_slug": "success_logs",
6	"name": "Successful Requests",
7	"condition_type": "single_log",
8	"description": "Matches spans with HTTP status code 200",
9	"condition_policy": {
10	"rules": [
11	{
12	"field": "status_code",
13	"operator": "equals",
14	"value": 200
15	}
16	],
17	"connector": "AND"
18	},
19	"unique_organization_id": "org-abc123",
20	"created_at": "2025-01-15T10:00:00Z",
21	"updated_at": "2025-01-15T10:00:00Z"
22	}
23	],
24	"count": 1,
25	"next": null,
26	"previous": null,
27	"filters_data": {}
28	}

1	{
2	"detail": "Authentication credentials were not provided."
3	}