> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/api/references/control-execution/assets.md).

# Assets

Discover and analyze assets affected by control failures. Use these endpoints to retrieve failed assets for specific controls or across all controls, and drill down to the root cause assets behind a failure. Supports cursor-based pagination and multiple sorting options.

## List failed assets for a control

> Returns a list of assets that have failed the control.\
> \
> Returns only the assets on which the authenticated user has view permissions.<br>

```json
{"openapi":"3.1.0","info":{"title":"Collibra Control Execution API","version":"1.0.0"},"tags":[{"name":"Assets","description":"Discover and analyze assets affected by control failures. Use these endpoints to retrieve failed assets\nfor specific controls or across all controls, and drill down to the root cause assets behind a failure.\nSupports cursor-based pagination and multiple sorting options.\n"}],"servers":[{"url":"/rest/controlExecution/v1"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"description":"This API requires Basic HTTP authentication.","type":"http","scheme":"basic"}},"parameters":{"controlId":{"name":"controlId","in":"path","required":true,"description":"The unique identifier of the control.\n","schema":{"type":"string","format":"uuid"}},"cursor":{"name":"cursor","in":"query","required":false,"description":"The cursor pointing to the first resource to be included in the response. This cursor cannot be created and must\nhave been extracted from a response returned by a previous API call.\n\nIf not set, the response starts from the first available resource.\n","schema":{"type":"string"}},"limit":{"name":"limit","in":"query","required":false,"description":"The maximum number of resources to retrieve.\n\nIf not set, the default value is 100. The maximum value is 500.\n","schema":{"type":"integer","default":100,"maximum":500,"minimum":1}},"includeTotal":{"name":"includeTotal","in":"query","required":false,"description":"Whether to include the total number of resources in the response.\n\nIf `true`, the response will include the total number of resources (`total`), as well as a boolean indicating if\nthe total is approximate (`isTotalApproximate`).\n\nIf `false`, the response will not include the total number of resources (`total` and `isTotalApproximate`).\n","schema":{"type":"boolean","default":true}},"assetSortField":{"name":"sortField","in":"query","required":false,"description":"The field on which the failed assets are sorted. The default value is `NAME`.\n","schema":{"type":"string","default":"NAME","enum":["NAME","CONTROL","COMMUNITY"]}},"sortOrder":{"name":"sortOrder","in":"query","required":false,"description":"The sorting order. The default value is `ASC`.\n","schema":{"type":"string","default":"ASC","enum":["ASC","DESC"]}}},"responses":{"FailedAssetsResponse":{"description":"Response containing the failed assets for a specific control with pagination support.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedFailedAssets"}}}},"BadRequest":{"description":"The request contains invalid parameters or is missing required data. Details about the validation errors are\nprovided in the response.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}},"NotFoundResponse":{"description":"The request references a resource that is not available.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}},"InternalServerError":{"description":"The server encountered an unexpected condition that prevented it from fulfilling the request. The error details\nprovide information for troubleshooting.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}}},"schemas":{"PaginatedFailedAssets":{"type":"object","description":"A paginated response containing assets that have failed the control.\n","required":["results"],"properties":{"nextCursor":{"$ref":"#/components/schemas/NextCursor"},"total":{"$ref":"#/components/schemas/Total"},"isTotalApproximate":{"$ref":"#/components/schemas/TotalApproximate"},"results":{"description":"Array of failed assets.","type":"array","items":{"$ref":"#/components/schemas/FailedAsset"}}}},"NextCursor":{"description":"Cursor pointing to the next page. If missing, this means that there are no additional pages of resources\navailable after the current one.\n","type":"string"},"Total":{"type":"integer","description":"The total number of resources matching the request."},"TotalApproximate":{"type":"boolean","description":"Indicates if the total is approximate. Failed asset counts stop at 1000: beyond that the API reports `1000`\nwith this flag set to `true`. Failed control counts are always exact, so this is always `false` for them.\n"},"FailedAsset":{"allOf":[{"$ref":"#/components/schemas/Asset"},{"type":"object","properties":{"description":{"type":"string","description":"The description of the asset."},"control":{"$ref":"#/components/schemas/ControlReference"},"community":{"$ref":"#/components/schemas/CommunityReference"},"parentCommunity":{"allOf":[{"$ref":"#/components/schemas/CommunityReference"},{"deprecated":true,"description":"Deprecated. Use `community` instead. Returns the same value as `community`."}]}}}]},"Asset":{"type":"object","description":"An asset of the Knowledge Graph.\n","required":["id","name","assetType"],"properties":{"id":{"type":"string","description":"The unique identifier of the asset.","format":"uuid"},"name":{"type":"string","description":"The name of the asset."},"assetType":{"$ref":"#/components/schemas/AssetType"}}},"AssetType":{"type":"object","description":"Represents an asset type reference.","properties":{"id":{"description":"The ID of the asset type.","format":"uuid","type":"string"},"name":{"description":"The name of the asset type.","type":"string"},"symbol":{"$ref":"#/components/schemas/SymbolData"}},"required":["id","name"]},"SymbolData":{"description":"The symbol data of the type.","type":"object","required":["acronymCode","color","symbolType"],"properties":{"acronymCode":{"type":"string","description":"The acronym code of the symbol.\n"},"color":{"type":"string","description":"The hex color code of the symbol.\n"},"iconCode":{"type":"string","description":"The icon code of the symbol.\n"},"symbolType":{"$ref":"#/components/schemas/SymbolType"}}},"SymbolType":{"description":"The symbol type.\n","enum":["NONE","ICON_CODE","ACRONYM_CODE"],"type":"string"},"ControlReference":{"type":"object","description":"Represents a control reference.","properties":{"id":{"description":"The ID of the control.","format":"uuid","type":"string"},"name":{"description":"The name of the control.","type":"string"}},"required":["id","name"]},"CommunityReference":{"type":"object","description":"Represents a community reference.","properties":{"id":{"description":"The ID of the community.","format":"uuid","type":"string"},"name":{"description":"The name of the community.","type":"string"}},"required":["id","name"]},"StandardErrorResponse":{"description":"A standard error response object.\n\n`titleMessage`, `helpMessage` and `userMessage` all carry the same text: the reason phrase of the status code\nfor `5xx` responses, and the error detail for `4xx` responses. Do not rely on them differing.\n","type":"object","properties":{"statusCode":{"description":"HTTP response code.","type":"integer"},"titleMessage":{"description":"The error message. Same text as `helpMessage` and `userMessage`.\n","type":"string"},"helpMessage":{"description":"The error message. Same text as `titleMessage` and `userMessage`.\n","type":"string"},"userMessage":{"description":"The error message. Same text as `titleMessage` and `helpMessage`.\n","type":"string"},"errorCode":{"description":"An error code identifier. Unless the individual response documents otherwise, this is the name of the\nHTTP status, such as `BAD_REQUEST` or `INTERNAL_SERVER_ERROR`.\n","type":"string"}},"required":["statusCode","errorCode","userMessage"]}}},"paths":{"/controls/{controlId}/assets/failed":{"get":{"tags":["Assets"],"summary":"List failed assets for a control","description":"Returns a list of assets that have failed the control.\n\nReturns only the assets on which the authenticated user has view permissions.\n","operationId":"findFailedAssetsByControlId","parameters":[{"$ref":"#/components/parameters/controlId"},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/includeTotal"},{"$ref":"#/components/parameters/assetSortField"},{"$ref":"#/components/parameters/sortOrder"}],"responses":{"200":{"$ref":"#/components/responses/FailedAssetsResponse"},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFoundResponse"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```

## List root cause assets for a control, failed asset, and requirement

> Returns a list of root cause assets that are causing a specific asset to fail a given requirement of a control.\
> The ID of the requirement is provided as a query parameter (See \`requirementId\`). The requirement IDs are returned by\
> the \`getControlRequirements\` endpoint of the Control Tower Management API.\
> \
> Root cause assets are the underlying assets that directly contribute to the control failure (based on the requirements defined in the query).\
> For example, if a table fails a data quality control, the root cause assets might be the specific\
> columns or fields within that table that contain the problematic data.\
> \
> Returns only the root cause assets on which the authenticated user has view permissions.<br>

```json
{"openapi":"3.1.0","info":{"title":"Collibra Control Execution API","version":"1.0.0"},"tags":[{"name":"Assets","description":"Discover and analyze assets affected by control failures. Use these endpoints to retrieve failed assets\nfor specific controls or across all controls, and drill down to the root cause assets behind a failure.\nSupports cursor-based pagination and multiple sorting options.\n"}],"servers":[{"url":"/rest/controlExecution/v1"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"description":"This API requires Basic HTTP authentication.","type":"http","scheme":"basic"}},"parameters":{"controlId":{"name":"controlId","in":"path","required":true,"description":"The unique identifier of the control.\n","schema":{"type":"string","format":"uuid"}},"assetIdInPath":{"name":"assetId","in":"path","required":true,"description":"The unique identifier of the asset.\n","schema":{"type":"string","format":"uuid"}},"requirementId":{"name":"requirementId","in":"query","required":true,"description":"The ID of a requirement is a 17-characters string that combines the `versionHash` of the parent `Control Query` with the `versionHash`\nof the `Filter` marked as a requirement.  The 2 hashes are `-` separated.\n\nFor example:\n  - `versionHash` of the `ControlQuery` is `ba7816bf`\n  - `versionHash` of the `Filter` is `cd294a01`\n  - The identifier of the requirement is `ba7816bf-cd294a01`\n\nThe requirement IDs are returned by the `getControlRequirements` endpoint of the Control Tower Management API.\n","schema":{"type":"string","minLength":17,"maxLength":17}},"cursor":{"name":"cursor","in":"query","required":false,"description":"The cursor pointing to the first resource to be included in the response. This cursor cannot be created and must\nhave been extracted from a response returned by a previous API call.\n\nIf not set, the response starts from the first available resource.\n","schema":{"type":"string"}},"limit":{"name":"limit","in":"query","required":false,"description":"The maximum number of resources to retrieve.\n\nIf not set, the default value is 100. The maximum value is 500.\n","schema":{"type":"integer","default":100,"maximum":500,"minimum":1}}},"responses":{"RootCauseAssetsResponse":{"description":"Response containing the root cause assets for a specific failed asset of a control with cursor-based pagination.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedRootCauseAssets"}}}},"BadRequest":{"description":"The request contains invalid parameters or is missing required data. Details about the validation errors are\nprovided in the response.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}},"NotFoundResponse":{"description":"The request references a resource that is not available.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}},"ControlConflictingResponse":{"description":"The control available in the execution service is not in the expected state to fulfill the request.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}},"InternalServerError":{"description":"The server encountered an unexpected condition that prevented it from fulfilling the request. The error details\nprovide information for troubleshooting.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}}},"schemas":{"PaginatedRootCauseAssets":{"type":"object","description":"A paginated response containing root cause assets with cursor-based pagination.\n","required":["results"],"properties":{"nextCursor":{"$ref":"#/components/schemas/NextCursor"},"results":{"type":"array","description":"Array of root cause assets for the current page.","items":{"$ref":"#/components/schemas/RootCauseAsset"}},"lagStatus":{"$ref":"#/components/schemas/QueryLagStatus"},"lastCommittedOn":{"$ref":"#/components/schemas/QueryLastCommittedOn"}}},"NextCursor":{"description":"Cursor pointing to the next page. If missing, this means that there are no additional pages of resources\navailable after the current one.\n","type":"string"},"RootCauseAsset":{"description":"An asset that causes the control to fail for a given asset.\n","allOf":[{"$ref":"#/components/schemas/AssetWithDomain"}]},"AssetWithDomain":{"allOf":[{"$ref":"#/components/schemas/Asset"},{"type":"object","required":["domain"],"properties":{"domain":{"$ref":"#/components/schemas/DomainReference"}}}]},"Asset":{"type":"object","description":"An asset of the Knowledge Graph.\n","required":["id","name","assetType"],"properties":{"id":{"type":"string","description":"The unique identifier of the asset.","format":"uuid"},"name":{"type":"string","description":"The name of the asset."},"assetType":{"$ref":"#/components/schemas/AssetType"}}},"AssetType":{"type":"object","description":"Represents an asset type reference.","properties":{"id":{"description":"The ID of the asset type.","format":"uuid","type":"string"},"name":{"description":"The name of the asset type.","type":"string"},"symbol":{"$ref":"#/components/schemas/SymbolData"}},"required":["id","name"]},"SymbolData":{"description":"The symbol data of the type.","type":"object","required":["acronymCode","color","symbolType"],"properties":{"acronymCode":{"type":"string","description":"The acronym code of the symbol.\n"},"color":{"type":"string","description":"The hex color code of the symbol.\n"},"iconCode":{"type":"string","description":"The icon code of the symbol.\n"},"symbolType":{"$ref":"#/components/schemas/SymbolType"}}},"SymbolType":{"description":"The symbol type.\n","enum":["NONE","ICON_CODE","ACRONYM_CODE"],"type":"string"},"DomainReference":{"type":"object","description":"Represents a domain reference.","properties":{"id":{"description":"The ID of the domain.","format":"uuid","type":"string"},"name":{"description":"The name of the domain.","type":"string"}},"required":["id","name"]},"QueryLagStatus":{"type":["string","null"],"description":"Indicates how up-to-date the data backing this query is, relative to the latest committed\nstate. Known values: CURRENT, SLIGHTLY_BEHIND, MODERATELY_BEHIND, HEAVILY_BEHIND,\nCRITICALLY_BEHIND, UNKNOWN. Null if the value was unavailable. For paginated responses,\nthis reflects the state at the time the current page was fetched and may differ across pages.\n"},"QueryLastCommittedOn":{"type":["string","null"],"format":"date-time","description":"The timestamp of the last committed state that the data backing this query reflects. Null if\nthe value was unavailable or could not be parsed. For paginated responses, this reflects the\nstate at the time the current page was fetched and may differ across pages.\n"},"StandardErrorResponse":{"description":"A standard error response object.\n\n`titleMessage`, `helpMessage` and `userMessage` all carry the same text: the reason phrase of the status code\nfor `5xx` responses, and the error detail for `4xx` responses. Do not rely on them differing.\n","type":"object","properties":{"statusCode":{"description":"HTTP response code.","type":"integer"},"titleMessage":{"description":"The error message. Same text as `helpMessage` and `userMessage`.\n","type":"string"},"helpMessage":{"description":"The error message. Same text as `titleMessage` and `userMessage`.\n","type":"string"},"userMessage":{"description":"The error message. Same text as `titleMessage` and `helpMessage`.\n","type":"string"},"errorCode":{"description":"An error code identifier. Unless the individual response documents otherwise, this is the name of the\nHTTP status, such as `BAD_REQUEST` or `INTERNAL_SERVER_ERROR`.\n","type":"string"}},"required":["statusCode","errorCode","userMessage"]}}},"paths":{"/controls/{controlId}/assets/{assetId}/rootCauseAssets":{"get":{"tags":["Assets"],"summary":"List root cause assets for a control, failed asset, and requirement","description":"Returns a list of root cause assets that are causing a specific asset to fail a given requirement of a control.\nThe ID of the requirement is provided as a query parameter (See `requirementId`). The requirement IDs are returned by\nthe `getControlRequirements` endpoint of the Control Tower Management API.\n\nRoot cause assets are the underlying assets that directly contribute to the control failure (based on the requirements defined in the query).\nFor example, if a table fails a data quality control, the root cause assets might be the specific\ncolumns or fields within that table that contain the problematic data.\n\nReturns only the root cause assets on which the authenticated user has view permissions.\n","operationId":"getRootCauseAssetsByControlAndAsset","parameters":[{"$ref":"#/components/parameters/controlId"},{"$ref":"#/components/parameters/assetIdInPath"},{"$ref":"#/components/parameters/requirementId"},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"$ref":"#/components/responses/RootCauseAssetsResponse"},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFoundResponse"},"409":{"$ref":"#/components/responses/ControlConflictingResponse"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```

## List all failed assets

> Returns a list of all assets that have failed.<br>

```json
{"openapi":"3.1.0","info":{"title":"Collibra Control Execution API","version":"1.0.0"},"tags":[{"name":"Assets","description":"Discover and analyze assets affected by control failures. Use these endpoints to retrieve failed assets\nfor specific controls or across all controls, and drill down to the root cause assets behind a failure.\nSupports cursor-based pagination and multiple sorting options.\n"}],"servers":[{"url":"/rest/controlExecution/v1"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"description":"This API requires Basic HTTP authentication.","type":"http","scheme":"basic"}},"parameters":{"cursor":{"name":"cursor","in":"query","required":false,"description":"The cursor pointing to the first resource to be included in the response. This cursor cannot be created and must\nhave been extracted from a response returned by a previous API call.\n\nIf not set, the response starts from the first available resource.\n","schema":{"type":"string"}},"limit":{"name":"limit","in":"query","required":false,"description":"The maximum number of resources to retrieve.\n\nIf not set, the default value is 100. The maximum value is 500.\n","schema":{"type":"integer","default":100,"maximum":500,"minimum":1}},"includeTotal":{"name":"includeTotal","in":"query","required":false,"description":"Whether to include the total number of resources in the response.\n\nIf `true`, the response will include the total number of resources (`total`), as well as a boolean indicating if\nthe total is approximate (`isTotalApproximate`).\n\nIf `false`, the response will not include the total number of resources (`total` and `isTotalApproximate`).\n","schema":{"type":"boolean","default":true}},"assetSortField":{"name":"sortField","in":"query","required":false,"description":"The field on which the failed assets are sorted. The default value is `NAME`.\n","schema":{"type":"string","default":"NAME","enum":["NAME","CONTROL","COMMUNITY"]}},"sortOrder":{"name":"sortOrder","in":"query","required":false,"description":"The sorting order. The default value is `ASC`.\n","schema":{"type":"string","default":"ASC","enum":["ASC","DESC"]}}},"responses":{"FailedAssetsResponse":{"description":"Response containing the failed assets for a specific control with pagination support.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedFailedAssets"}}}},"BadRequest":{"description":"The request contains invalid parameters or is missing required data. Details about the validation errors are\nprovided in the response.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}},"InternalServerError":{"description":"The server encountered an unexpected condition that prevented it from fulfilling the request. The error details\nprovide information for troubleshooting.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}}},"schemas":{"PaginatedFailedAssets":{"type":"object","description":"A paginated response containing assets that have failed the control.\n","required":["results"],"properties":{"nextCursor":{"$ref":"#/components/schemas/NextCursor"},"total":{"$ref":"#/components/schemas/Total"},"isTotalApproximate":{"$ref":"#/components/schemas/TotalApproximate"},"results":{"description":"Array of failed assets.","type":"array","items":{"$ref":"#/components/schemas/FailedAsset"}}}},"NextCursor":{"description":"Cursor pointing to the next page. If missing, this means that there are no additional pages of resources\navailable after the current one.\n","type":"string"},"Total":{"type":"integer","description":"The total number of resources matching the request."},"TotalApproximate":{"type":"boolean","description":"Indicates if the total is approximate. Failed asset counts stop at 1000: beyond that the API reports `1000`\nwith this flag set to `true`. Failed control counts are always exact, so this is always `false` for them.\n"},"FailedAsset":{"allOf":[{"$ref":"#/components/schemas/Asset"},{"type":"object","properties":{"description":{"type":"string","description":"The description of the asset."},"control":{"$ref":"#/components/schemas/ControlReference"},"community":{"$ref":"#/components/schemas/CommunityReference"},"parentCommunity":{"allOf":[{"$ref":"#/components/schemas/CommunityReference"},{"deprecated":true,"description":"Deprecated. Use `community` instead. Returns the same value as `community`."}]}}}]},"Asset":{"type":"object","description":"An asset of the Knowledge Graph.\n","required":["id","name","assetType"],"properties":{"id":{"type":"string","description":"The unique identifier of the asset.","format":"uuid"},"name":{"type":"string","description":"The name of the asset."},"assetType":{"$ref":"#/components/schemas/AssetType"}}},"AssetType":{"type":"object","description":"Represents an asset type reference.","properties":{"id":{"description":"The ID of the asset type.","format":"uuid","type":"string"},"name":{"description":"The name of the asset type.","type":"string"},"symbol":{"$ref":"#/components/schemas/SymbolData"}},"required":["id","name"]},"SymbolData":{"description":"The symbol data of the type.","type":"object","required":["acronymCode","color","symbolType"],"properties":{"acronymCode":{"type":"string","description":"The acronym code of the symbol.\n"},"color":{"type":"string","description":"The hex color code of the symbol.\n"},"iconCode":{"type":"string","description":"The icon code of the symbol.\n"},"symbolType":{"$ref":"#/components/schemas/SymbolType"}}},"SymbolType":{"description":"The symbol type.\n","enum":["NONE","ICON_CODE","ACRONYM_CODE"],"type":"string"},"ControlReference":{"type":"object","description":"Represents a control reference.","properties":{"id":{"description":"The ID of the control.","format":"uuid","type":"string"},"name":{"description":"The name of the control.","type":"string"}},"required":["id","name"]},"CommunityReference":{"type":"object","description":"Represents a community reference.","properties":{"id":{"description":"The ID of the community.","format":"uuid","type":"string"},"name":{"description":"The name of the community.","type":"string"}},"required":["id","name"]},"StandardErrorResponse":{"description":"A standard error response object.\n\n`titleMessage`, `helpMessage` and `userMessage` all carry the same text: the reason phrase of the status code\nfor `5xx` responses, and the error detail for `4xx` responses. Do not rely on them differing.\n","type":"object","properties":{"statusCode":{"description":"HTTP response code.","type":"integer"},"titleMessage":{"description":"The error message. Same text as `helpMessage` and `userMessage`.\n","type":"string"},"helpMessage":{"description":"The error message. Same text as `titleMessage` and `userMessage`.\n","type":"string"},"userMessage":{"description":"The error message. Same text as `titleMessage` and `helpMessage`.\n","type":"string"},"errorCode":{"description":"An error code identifier. Unless the individual response documents otherwise, this is the name of the\nHTTP status, such as `BAD_REQUEST` or `INTERNAL_SERVER_ERROR`.\n","type":"string"}},"required":["statusCode","errorCode","userMessage"]}}},"paths":{"/assets/failed":{"get":{"tags":["Assets"],"summary":"List all failed assets","description":"Returns a list of all assets that have failed.\n","operationId":"findAllFailedAssets","parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/includeTotal"},{"$ref":"#/components/parameters/assetSortField"},{"$ref":"#/components/parameters/sortOrder"}],"responses":{"200":{"$ref":"#/components/responses/FailedAssetsResponse"},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developer.collibra.com/api/references/control-execution/assets.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
