List prompts

get

https://www.virustotal.com/api/v3/agent/prompts

Lists the prompts owned by or shared with the authenticated user, with support for filtering, ordering and cursor-based pagination.

Examples

List the first prompts in your library, filtering by tag and sorting by most recently modified.

import requests

url = "https://www.virustotal.com/api/v3/agent/prompts"
headers = {"accept": "application/json", "x-apikey": <api-key>}
params = {"filter": "tag:malware", "order": "last_updated-", "limit": 10}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
page = response.json()

for prompt in page["data"]:
    print(prompt["id"], prompt["attributes"]["name"])

# Follow the cursor to fetch the next page, if any
cursor = page.get("meta", {}).get("cursor")
if cursor:
    next_page = requests.get(
        url,
        headers=headers,
        params={"cursor": cursor, "limit": 10},
    ).json()

Responses

400

Invalid parameter value or malformed order syntax.

401

Missing or invalid API key.

403

User or group lacks permission to access Agentic API features.

Examples

200A page of prompts owned by or shared with the authenticated user.