Filter by ID API
Update or delete an individual saved filter.
PUT /filters/{id}
Update an existing saved filter.
Request
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Filter identifier (path parameter) |
Response
200 OK
Returns the updated filter.
Example
curl -X PUT "https://api.kenbun.io/filters/filter-123" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"name": "Updated Filter", "criteria": {"min_score": 80}}'
DELETE /filters/{id}
Delete a saved filter. This action cannot be undone.
Request
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Filter identifier (path parameter) |
Response
204 No Content
Example
curl -X DELETE "https://api.kenbun.io/filters/filter-123" \
-H "Authorization: Bearer <token>"
Common Errors
| Status | Meaning | Solution |
|---|---|---|
| 401 | Unauthorized | Check authentication token |
| 404 | Not Found | Filter does not exist |
Related Endpoints
- Filters - List and create filters