API Reference
API Reference

List cloud assets

post
https://app.aikido.dev/api/public/v1/clouds/assets

Returns cloud assets for the connected clouds in your account. Supports pagination, filtering and search parameters similar to the cloud inventory UI. AI cloud search through this public endpoint expects prompts to be created in the Aikido app first and reused via prompt_id.

Body Params

The parameters used to fetch cloud assets

integer

Pagination parameter, starts at 0.

integer

Amount of assets returned.

string

Optional free-text search over asset metadata. Use this for direct keyword matching rather than AI cloud search.

string

Optional sort definition. Supported fields are name, asset_type, region, source_id, cloud_id. Example: asset_type:asc,region:desc.

integer

Optional existing prompt identifier to reuse a previous AI cloud search plan. For AI cloud search, create the prompt in the Aikido app first and then provide that prompt_id here.

boolean

When set to true, returns the full metadata object for each asset.

metadata_fields
array of strings

Optional list of metadata paths to project into the selected_metadata response field. This is projection, not filtering. The fields follow the provider-specific case convention (e.g., for AWS, they are PascalCase, while for Azure/GCP they are camelCase).

metadata_fields
filters
object

Exact-match multi-value filters. Filter keys are combined with AND semantics, while values within each filter use IN semantics. Empty arrays are ignored.

Response

Updated 1 day ago

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 1 day ago