Skip to main content

Vulnerabilities

Use this page to work through a vulnerability backlog: find an issue, inspect it, assign an owner, then change its status individually or in bulk.

List vulnerabilities​

List vulnerabilities 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 <issue_id> in the actions below.

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

Inspect and assign a vulnerability​

Get vulnerability details

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 GetIssue($id: ID!) {\n issue(id: $id) {\n id\n title\n status\n }\n}","variables":{"id":"<issue_id>"}}'

Assign a vulnerability owner

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 UpdateIssueAssignee($input: UpdateIssueAssigneesInput!) {\n updateIssueAssignee(input: $input) {\n assignees { id name }\n }\n}","variables":{"input":{"issueId":"<issue_id>","assigneeEmails":["owner@example.com"]}}}'

Change status​

Use the single-item mutation for one vulnerability. Use the bulk mutation when the same transition applies to multiple IDs.

Change one vulnerability status

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 ChangeIssueStatus($input: ChangeIssueStatusInput!) {\n changeIssueStatus(input: $input) {\n issue { id title status }\n }\n}","variables":{"input":{"id":"<issue_id>","status":"CREATED"}}}'

Change status for multiple vulnerabilities

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 BulkChangeIssueStatus($input: BulkChangeIssueStatusInput!) {\n bulkChangeIssueStatus(input: $input) {\n jobId\n }\n}","variables":{"input":{"companyId":"<company_id>","ids":["<issue_id>"],"status":"CREATED"}}}'

For filters, finding types, and less common vulnerability 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