Skip to main content

Assets and applications

Use this page to manage an asset inventory. Start with the company scope, then reuse returned IDs in the mutations.

List applications​

List applications in a company

This generated query uses placeholders for required values. Replace them with values available to your API key before running it.

curl --request POST https://api.convisoappsec.com/graphql \
--header "x-api-key: $CONVISO_API_KEY" \
--header "content-type: application/json" \
--data '{"query":"query GetApplications($companyId: ID!) {\n applications(companyId: $companyId) {\n id\n name\n }\n}","variables":{"companyId":"<company_id>"}}'

List assets​

List assets in a company

This generated query uses placeholders for required values. Replace them with values available to your API key before running it.

Before you run it

Use collection[].id as <asset_id> for update or archive operations.

curl --request POST https://api.convisoappsec.com/graphql \
--header "x-api-key: $CONVISO_API_KEY" \
--header "content-type: application/json" \
--data '{"query":"query GetAssets($companyId: ID!) {\n assets(companyId: $companyId) {\n collection { id name }\n metadata { currentPage limitValue totalCount }\n }\n}","variables":{"companyId":"<company_id>"}}'

Create or update an asset​

The exact optional fields depend on the asset type. The reference exposes the complete CreateAssetInput and UpdateAssetInput shapes.

Create an asset

This generated mutation uses placeholders for required values. Replace them with values available to your API key before running it.

curl --request POST https://api.convisoappsec.com/graphql \
--header "x-api-key: $CONVISO_API_KEY" \
--header "content-type: application/json" \
--data '{"query":"mutation CreateAsset($input: CreateAssetInput!) {\n createAsset(input: $input) {\n errors\n asset { id name }\n }\n}","variables":{"input":{"companyId":"<company_id>"}}}'

Update an asset

This generated mutation uses placeholders for required values. Replace them with values available to your API key before running it.

curl --request POST https://api.convisoappsec.com/graphql \
--header "x-api-key: $CONVISO_API_KEY" \
--header "content-type: application/json" \
--data '{"query":"mutation UpdateAsset($input: UpdateAssetInput!) {\n updateAsset(input: $input) {\n asset { id name }\n }\n}","variables":{"input":{"companyId":"<company_id>","id":"<asset_id>"}}}'

Archive assets​

Archiving removes assets from active use while retaining their history.

Archive selected assets

This generated mutation uses placeholders for required values. Replace them with values available to your API key before running it.

curl --request POST https://api.convisoappsec.com/graphql \
--header "x-api-key: $CONVISO_API_KEY" \
--header "content-type: application/json" \
--data '{"query":"mutation ArchiveAssets($input: ArchiveAssetsInput!) {\n archiveAssets(input: $input) {\n clientMutationId\n }\n}","variables":{"input":{"companyId":"<company_id>","assetIds":["<asset_id>"]}}}'

For advanced asset, repository, and branch operations, use the complete schema.

Contribute to the Docs

Found something outdated or missing? Help us improve the documentation with a quick suggestion or edit.

How to contribute