Get cloud assets

get

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. Array-valued filters are passed as comma-separated values. AI cloud search through this public endpoint expects prompts to be created in the Aikido app first and reused via prompt_id.

Query Params

page

integer

Pagination parameter, starts at 0.

limit

integer

Amount of assets returned.

string

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

sort

string

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

prompt_id

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.

include_metadata

boolean

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

metadata_fields

array of strings

Optional comma-separated 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

asset_type

array of strings

Filter assets by one or more comma-separated asset types.

asset_type

region

array of strings

Filter assets by one or more comma-separated regions.

region

cloud_id

array of integers

Filter assets by one or more comma-separated Aikido cloud ids.

cloud_id

provider

array of strings

Filter assets by one or more comma-separated cloud providers.

provider

Allowed:

source_id

array of strings

Filter assets by one or more comma-separated provider-specific source ids. This filter is request-only and is not returned in response filter buckets.

source_id

Response

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A paginated list of cloud assets.