> For the complete documentation index, see [llms.txt](https://docs.truedat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.truedat.io/v8.12/api-integrations/data-quality-apis/executions.md).
# Executions
## Search executions
> Searches quality executions using a JSON request body instead of query parameters. This endpoint is equivalent to the executions listing, but accepts filters, pagination, and source scope as part of the request payload.\
> \
> Requires the \*\*'View quality'\*\* permission. Administrators and service accounts are always allowed.\
> \
> \*\*Request body:\*\*\
> \- \`page\` (optional, integer) – Page number. Default: \`0\`.\
> \- \`size\` (optional, integer) – Page size. Default: \`20\`.\
> \- \`filters\` (optional, object) – Filter criteria forwarded to the underlying listing.\
> \- \`status\` (optional, string) – Convenience filter for the execution status (for example, \`"pending"\`).\
> \- \`sources\` (optional, array of strings) – Restrict the search to the given source external IDs.\
> \
> Delegates to the standard executions listing after injecting the body parameters. The response shape matches the executions index and is enriched with implementation, result, and group information.\
> \
> This endpoint exists for clients that prefer sending search criteria in the request body. It does not implement Elasticsearch‑style scrolling; use the general implementation search endpoint if you need pagination across large result sets.
```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.11.0"},"paths":{"/api/executions/search":{"post":{"description":"Searches quality executions using a JSON request body instead of query parameters. This endpoint is equivalent to the executions listing, but accepts filters, pagination, and source scope as part of the request payload.\n\nRequires the **'View quality'** permission. Administrators and service accounts are always allowed.\n\n**Request body:**\n- `page` (optional, integer) – Page number. Default: `0`.\n- `size` (optional, integer) – Page size. Default: `20`.\n- `filters` (optional, object) – Filter criteria forwarded to the underlying listing.\n- `status` (optional, string) – Convenience filter for the execution status (for example, `\"pending\"`).\n- `sources` (optional, array of strings) – Restrict the search to the given source external IDs.\n\nDelegates to the standard executions listing after injecting the body parameters. The response shape matches the executions index and is enriched with implementation, result, and group information.\n\nThis endpoint exists for clients that prefer sending search criteria in the request body. It does not implement Elasticsearch‑style scrolling; use the general implementation search endpoint if you need pagination across large result sets.\n","operationId":"TdDqWeb.ExecutionSearchController.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionSearchRequest"}}},"description":"Execution search request","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionSearchResponse"}}},"description":"Execution search response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Search executions","tags":["Executions"]}}},"components":{"schemas":{"ExecutionSearchRequest":{"additionalProperties":true,"properties":{"filters":{"additionalProperties":true,"description":"Filter criteria","type":"object"},"page":{"default":0,"description":"Page number","minimum":0,"type":"integer"},"size":{"default":20,"description":"Page size","minimum":1,"type":"integer"},"sources":{"description":"Filter by source external IDs","items":{"type":"string"},"nullable":true,"type":"array"},"status":{"description":"Filter by status","nullable":true,"type":"string"}},"title":"ExecutionSearchRequest","type":"object"},"ExecutionSearchResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"required":["data"],"title":"ExecutionSearchResponse","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```
## List executions
> Returns a list of quality executions visible to the current user.\
> \
> Requires the \*\*'View quality'\*\* permission. Administrators and service accounts are always allowed.\
> \
> \*\*Query parameter:\*\*\
> \- \`group\_id\` (optional, integer) – Restrict the result to executions belonging to the specified execution group. When omitted, all executions visible to the caller are returned.\
> \
> No pagination is applied; the full filtered list is returned. Each execution is enriched with its implementation, result, and group.\
> \
> Because the filter is applied globally rather than per‑domain, the caller's \`view\_quality\_rule\` permission determines which executions appear. If the referenced \`group\_id\` does not exist, the endpoint returns an empty list rather than a \`404\`.
```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.11.0"},"paths":{"/api/execution_groups/{execution_group_id}/executions":{"get":{"description":"Returns a list of quality executions visible to the current user.\n\nRequires the **'View quality'** permission. Administrators and service accounts are always allowed.\n\n**Query parameter:**\n- `group_id` (optional, integer) – Restrict the result to executions belonging to the specified execution group. When omitted, all executions visible to the caller are returned.\n\nNo pagination is applied; the full filtered list is returned. Each execution is enriched with its implementation, result, and group.\n\nBecause the filter is applied globally rather than per‑domain, the caller's `view_quality_rule` permission determines which executions appear. If the referenced `group_id` does not exist, the endpoint returns an empty list rather than a `404`.\n","operationId":"TdDqWeb.ExecutionController.index (2)","parameters":[{"description":"Filter by execution group ID","in":"query","name":"group_id","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionIndexResponse"}}},"description":"Executions response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List executions","tags":["Executions"]}}},"components":{"schemas":{"ExecutionIndexResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"required":["data"],"title":"ExecutionIndexResponse","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```
## List executions
> Returns a list of quality executions visible to the current user.\
> \
> Requires the \*\*'View quality'\*\* permission. Administrators and service accounts are always allowed.\
> \
> \*\*Query parameter:\*\*\
> \- \`group\_id\` (optional, integer) – Restrict the result to executions belonging to the specified execution group. When omitted, all executions visible to the caller are returned.\
> \
> No pagination is applied; the full filtered list is returned. Each execution is enriched with its implementation, result, and group.\
> \
> Because the filter is applied globally rather than per‑domain, the caller's \`view\_quality\_rule\` permission determines which executions appear. If the referenced \`group\_id\` does not exist, the endpoint returns an empty list rather than a \`404\`.
```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.11.0"},"paths":{"/api/executions":{"get":{"description":"Returns a list of quality executions visible to the current user.\n\nRequires the **'View quality'** permission. Administrators and service accounts are always allowed.\n\n**Query parameter:**\n- `group_id` (optional, integer) – Restrict the result to executions belonging to the specified execution group. When omitted, all executions visible to the caller are returned.\n\nNo pagination is applied; the full filtered list is returned. Each execution is enriched with its implementation, result, and group.\n\nBecause the filter is applied globally rather than per‑domain, the caller's `view_quality_rule` permission determines which executions appear. If the referenced `group_id` does not exist, the endpoint returns an empty list rather than a `404`.\n","operationId":"TdDqWeb.ExecutionController.index","parameters":[{"description":"Filter by execution group ID","in":"query","name":"group_id","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionIndexResponse"}}},"description":"Executions response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List executions","tags":["Executions"]}}},"components":{"schemas":{"ExecutionIndexResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"required":["data"],"title":"ExecutionIndexResponse","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```
## Get execution group
> Returns a single execution group by its ID, including its executions.\
> \
> Requires the \*\*'View quality'\*\* permission. Administrators and service accounts are always allowed.\
> \
> \*\*Behavior:\*\* The response includes each execution of the group, preloaded with:\
> \- \`implementation\` – The implementation being executed.\
> \- \`rule\` – The rule linked to the implementation, when present.\
> \- \`result\` – The result produced by the execution.\
> \- \`quality\_events\` – The events recorded for the execution.
```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.11.0"},"paths":{"/api/execution_groups/{id}":{"get":{"description":"Returns a single execution group by its ID, including its executions.\n\nRequires the **'View quality'** permission. Administrators and service accounts are always allowed.\n\n**Behavior:** The response includes each execution of the group, preloaded with:\n- `implementation` – The implementation being executed.\n- `rule` – The rule linked to the implementation, when present.\n- `result` – The result produced by the execution.\n- `quality_events` – The events recorded for the execution.\n","operationId":"TdDqWeb.ExecutionGroupController.show","parameters":[{"description":"Execution group ID","in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionGroupShowResponse"}}},"description":"Execution group response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqNotFoundResponse"}}},"description":"Not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Get execution group","tags":["Executions"]}}},"components":{"schemas":{"ExecutionGroupShowResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ExecutionGroup"}},"required":["data"],"title":"ExecutionGroupShowResponse","type":"object"},"ExecutionGroup":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"executions":{"description":"List of executions","items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"type":"object"},"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"id":{"description":"Execution group ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"ExecutionGroup","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqNotFoundResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```
## List execution groups
> Returns all execution groups visible to the current user.\
> \
> Requires the \*\*'View quality'\*\* permission. Administrators and service accounts are always allowed.\
> \
> No pagination is applied; the full list of execution groups is returned. Each group includes only its top‑level metadata; executions are not preloaded.\
> \
> The list is global (not filtered by domain or user), so the effective result set depends solely on the caller's \*\*'View quality'\*\* permission.
```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.11.0"},"paths":{"/api/execution_groups":{"get":{"description":"Returns all execution groups visible to the current user.\n\nRequires the **'View quality'** permission. Administrators and service accounts are always allowed.\n\nNo pagination is applied; the full list of execution groups is returned. Each group includes only its top‑level metadata; executions are not preloaded.\n\nThe list is global (not filtered by domain or user), so the effective result set depends solely on the caller's **'View quality'** permission.\n","operationId":"TdDqWeb.ExecutionGroupController.index","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionGroupIndexResponse"}}},"description":"Execution groups response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List execution groups","tags":["Executions"]}}},"components":{"schemas":{"ExecutionGroupIndexResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/ExecutionGroup"},"type":"array"}},"required":["data"],"title":"ExecutionGroupIndexResponse","type":"object"},"ExecutionGroup":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"executions":{"description":"List of executions","items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"type":"object"},"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"id":{"description":"Execution group ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"ExecutionGroup","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```
## Create execution group
> Creates a new execution group. The group is generated from a set of executions determined by the request payload.\
> \
> Requires the \*\*'Execute implementations'\*\* permission. Administrators and service accounts are always allowed.\
> \
> \*\*Request body (three mutually exclusive modes):\*\*\
> 1\. \*\*Explicit implementation IDs\*\* (\`implementation\_ids\`) – The payload carries a list of implementation IDs; the group is built from exactly those implementations.\
> 2\. \*\*Executable search\*\* (\`filters\`) – The payload carries filters that are resolved using the caller's executable search scope. Only implementations the caller is permitted to execute are included.\
> 3\. \*\*Direct executions\*\* (\`executions\`) – The payload carries execution objects already shaped as \`%{implementation\_id: ...}\` and they are used as is.\
> \
> All three modes accept an optional \`df\_content\` object, which is stored as the group's dynamic content and is used by the workflow for extra metadata.\
> \
> For each resolved implementation, the service stores its \`implementation\_id\` and any \`structure\_aliases\`, and then creates the executions inside the group. The response returns the created group with its executions preloaded.\
> \
> In search mode, the number of executions created depends on the caller's \*\*'Execute implementations'\*\* permission across domains; the effective scope is computed at request time. A \`Location\` header points to the newly created group.
```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.11.0"},"paths":{"/api/execution_groups":{"post":{"description":"Creates a new execution group. The group is generated from a set of executions determined by the request payload.\n\nRequires the **'Execute implementations'** permission. Administrators and service accounts are always allowed.\n\n**Request body (three mutually exclusive modes):**\n1. **Explicit implementation IDs** (`implementation_ids`) – The payload carries a list of implementation IDs; the group is built from exactly those implementations.\n2. **Executable search** (`filters`) – The payload carries filters that are resolved using the caller's executable search scope. Only implementations the caller is permitted to execute are included.\n3. **Direct executions** (`executions`) – The payload carries execution objects already shaped as `%{implementation_id: ...}` and they are used as is.\n\nAll three modes accept an optional `df_content` object, which is stored as the group's dynamic content and is used by the workflow for extra metadata.\n\nFor each resolved implementation, the service stores its `implementation_id` and any `structure_aliases`, and then creates the executions inside the group. The response returns the created group with its executions preloaded.\n\nIn search mode, the number of executions created depends on the caller's **'Execute implementations'** permission across domains; the effective scope is computed at request time. A `Location` header points to the newly created group.\n","operationId":"TdDqWeb.ExecutionGroupController.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionGroupCreateRequest"}}},"description":"Execution group creation request","required":false},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionGroupShowResponse"}}},"description":"Execution group response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnprocessableEntityResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Create execution group","tags":["Executions"]}}},"components":{"schemas":{"ExecutionGroupCreateRequest":{"additionalProperties":false,"oneOf":[{"properties":{"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"implementation_ids":{"description":"List of implementation IDs to execute","items":{"type":"integer"},"type":"array"}},"required":["implementation_ids"],"type":"object"},{"properties":{"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"filters":{"additionalProperties":true,"description":"Search filters to select implementations (e.g., {\"id\": [1,2]})","type":"object"}},"required":["filters"],"type":"object"},{"properties":{"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"executions":{"description":"Direct list of execution objects","items":{"additionalProperties":false,"properties":{"implementation_id":{"type":"integer"}},"required":["implementation_id"],"type":"object"},"type":"array"}},"required":["executions"],"type":"object"}],"title":"ExecutionGroupCreateRequest","type":"object"},"ExecutionGroupShowResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ExecutionGroup"}},"required":["data"],"title":"ExecutionGroupShowResponse","type":"object"},"ExecutionGroup":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"executions":{"description":"List of executions","items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"type":"object"},"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"id":{"description":"Execution group ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"ExecutionGroup","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqUnprocessableEntityResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnprocessableEntityResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```