---
title: "POST /blueprintactivity/search - Blueprint Activity · RUAL Documentation"
description: "Search blueprint execution activity and logs"
canonical: https://docs.rual.nl/cluster/api/blueprint-activity/blueprintactivity-search-post
language: en
---

# POST /blueprintactivity/search

Search blueprint execution activity and logs

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **[authorization](https://docs.rual.nl/cluster/api#token-providing)** required | `string` | `"Bearer access_token"` | Access token |

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **_source** optional | `string` | `"example"` | Fields to include/exclude in results |
| **aggs** optional | `object` | {} | Aggregations for analytics |
| **bool** optional | `object` | `{ "filter": [ {} ], "must": [ {} ], "must_not": [ {} ] }` ... and more | Boolean queries for complex logic |
| **count** optional | `boolean` | `false` | Return only count instead of documents |
| **exists** optional | `object` | `{ "field": "description" }` | Check if field exists |
| **from** optional | `integer` | `0` | Starting position for pagination |
| **highlight** optional | `object` | {} | Highlight matching text |
| **include_hits** optional | `boolean` | `false` | Include hit details in paginated results |
| **match** optional | `object` | `{ "title": "blueprint automation" }` | Full-text match queries |
| **range** optional | `object` | `{ "created": { "gte": "2024-01-01", "lte": "2024-12-31" } }` | Range queries for dates, numbers |
| **size** optional | `integer` | `10` | Number of results to return |
| **sort** optional | `array` | [{"created":{"order":"desc"}}, ...] | Sort criteria |
| **term** optional | `object` | `{ "status.keyword": { "value": "active" } }` | Term queries for exact matches |
| **terms** optional | `object` | `{ "category.keyword": [ "user", "admin" ] }` | Terms queries for multiple exact matches |
| **wildcard** optional | `object` | `{ "name.keyword": { "case_insensitive": true, "value": "user*" } }` | Wildcard pattern matching |

```
{}
```

```
{
  "code": 401,
  "error": "INVALID_ACCESS_TOKEN"
}
```

| Status | Error Code | Description |
| --- | --- | --- |
| `401` | `INVALID_ACCESS_TOKEN` | Authentication required or invalid token |

| Permission | Description |
| --- | --- |
| `Bearer token` | Access token required via Authorization header, x-authtoken, x-token, query param, or cookie |
| `blueprintactivity_view` | Required scope: blueprintactivity_view |