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.
Use collection[].id as <issue_id> in the actions below.
- cURL
- JavaScript
- Python
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":{}}}'
const response = await fetch('https://api.convisoappsec.com/graphql', {
method: 'POST',
headers: {
'content-type': 'application/json',
'x-api-key': process.env.CONVISO_API_KEY,
},
body: JSON.stringify({
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": {}
},
}),
});
const { data, errors } = await response.json();
if (errors) throw new Error(errors.map(({ message }) => message).join(', '));
console.log(data);
import json
import os
import requests
response = requests.post(
'https://api.convisoappsec.com/graphql',
headers={
'content-type': 'application/json',
'x-api-key': os.environ['CONVISO_API_KEY'],
},
json={
'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': json.loads("{\"companyId\":\"<company_id>\",\"pagination\":{}}"),
},
timeout=30,
)
response.raise_for_status()
payload = response.json()
if payload.get('errors'):
raise RuntimeError(payload['errors'])
print(payload['data'])
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
- JavaScript
- Python
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>"}}'
const response = await fetch('https://api.convisoappsec.com/graphql', {
method: 'POST',
headers: {
'content-type': 'application/json',
'x-api-key': process.env.CONVISO_API_KEY,
},
body: JSON.stringify({
query: "query GetIssue($id: ID!) {\n issue(id: $id) {\n id\n title\n status\n }\n}",
variables: {
"id": "<issue_id>"
},
}),
});
const { data, errors } = await response.json();
if (errors) throw new Error(errors.map(({ message }) => message).join(', '));
console.log(data);
import json
import os
import requests
response = requests.post(
'https://api.convisoappsec.com/graphql',
headers={
'content-type': 'application/json',
'x-api-key': os.environ['CONVISO_API_KEY'],
},
json={
'query': "query GetIssue($id: ID!) {\n issue(id: $id) {\n id\n title\n status\n }\n}",
'variables': json.loads("{\"id\":\"<issue_id>\"}"),
},
timeout=30,
)
response.raise_for_status()
payload = response.json()
if payload.get('errors'):
raise RuntimeError(payload['errors'])
print(payload['data'])
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
- JavaScript
- Python
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"]}}}'
const response = await fetch('https://api.convisoappsec.com/graphql', {
method: 'POST',
headers: {
'content-type': 'application/json',
'x-api-key': process.env.CONVISO_API_KEY,
},
body: JSON.stringify({
query: "mutation UpdateIssueAssignee($input: UpdateIssueAssigneesInput!) {\n updateIssueAssignee(input: $input) {\n assignees { id name }\n }\n}",
variables: {
"input": {
"issueId": "<issue_id>",
"assigneeEmails": [
"owner@example.com"
]
}
},
}),
});
const { data, errors } = await response.json();
if (errors) throw new Error(errors.map(({ message }) => message).join(', '));
console.log(data);
import json
import os
import requests
response = requests.post(
'https://api.convisoappsec.com/graphql',
headers={
'content-type': 'application/json',
'x-api-key': os.environ['CONVISO_API_KEY'],
},
json={
'query': "mutation UpdateIssueAssignee($input: UpdateIssueAssigneesInput!) {\n updateIssueAssignee(input: $input) {\n assignees { id name }\n }\n}",
'variables': json.loads("{\"input\":{\"issueId\":\"<issue_id>\",\"assigneeEmails\":[\"owner@example.com\"]}}"),
},
timeout=30,
)
response.raise_for_status()
payload = response.json()
if payload.get('errors'):
raise RuntimeError(payload['errors'])
print(payload['data'])
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
- JavaScript
- Python
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"}}}'
const response = await fetch('https://api.convisoappsec.com/graphql', {
method: 'POST',
headers: {
'content-type': 'application/json',
'x-api-key': process.env.CONVISO_API_KEY,
},
body: JSON.stringify({
query: "mutation ChangeIssueStatus($input: ChangeIssueStatusInput!) {\n changeIssueStatus(input: $input) {\n issue { id title status }\n }\n}",
variables: {
"input": {
"id": "<issue_id>",
"status": "CREATED"
}
},
}),
});
const { data, errors } = await response.json();
if (errors) throw new Error(errors.map(({ message }) => message).join(', '));
console.log(data);
import json
import os
import requests
response = requests.post(
'https://api.convisoappsec.com/graphql',
headers={
'content-type': 'application/json',
'x-api-key': os.environ['CONVISO_API_KEY'],
},
json={
'query': "mutation ChangeIssueStatus($input: ChangeIssueStatusInput!) {\n changeIssueStatus(input: $input) {\n issue { id title status }\n }\n}",
'variables': json.loads("{\"input\":{\"id\":\"<issue_id>\",\"status\":\"CREATED\"}}"),
},
timeout=30,
)
response.raise_for_status()
payload = response.json()
if payload.get('errors'):
raise RuntimeError(payload['errors'])
print(payload['data'])
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
- JavaScript
- Python
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"}}}'
const response = await fetch('https://api.convisoappsec.com/graphql', {
method: 'POST',
headers: {
'content-type': 'application/json',
'x-api-key': process.env.CONVISO_API_KEY,
},
body: JSON.stringify({
query: "mutation BulkChangeIssueStatus($input: BulkChangeIssueStatusInput!) {\n bulkChangeIssueStatus(input: $input) {\n jobId\n }\n}",
variables: {
"input": {
"companyId": "<company_id>",
"ids": [
"<issue_id>"
],
"status": "CREATED"
}
},
}),
});
const { data, errors } = await response.json();
if (errors) throw new Error(errors.map(({ message }) => message).join(', '));
console.log(data);
import json
import os
import requests
response = requests.post(
'https://api.convisoappsec.com/graphql',
headers={
'content-type': 'application/json',
'x-api-key': os.environ['CONVISO_API_KEY'],
},
json={
'query': "mutation BulkChangeIssueStatus($input: BulkChangeIssueStatusInput!) {\n bulkChangeIssueStatus(input: $input) {\n jobId\n }\n}",
'variables': json.loads("{\"input\":{\"companyId\":\"<company_id>\",\"ids\":[\"<issue_id>\"],\"status\":\"CREATED\"}}"),
},
timeout=30,
)
response.raise_for_status()
payload = response.json()
if payload.get('errors'):
raise RuntimeError(payload['errors'])
print(payload['data'])
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