Links

Endpoints List

This page lists commonly used endpoints with links directly to the folder in Postman.
This folder covers the following endpoints:
  • retrieve analytics on findings per client
  • retrieve number of aging findings for clients
  • retrieve analytics on findings assets

v2/Analytics

This folder covers the following endpoints:
  • retrieve analytics on findings open and closed for a client
  • retrieve analytics on findings from creation to closed for a client
  • retrieve analytics on age of open findings for a client
  • retrieve analytics on SLA mean-time of findings for a client
  • retrieve analytics on all SLAs for a client

v1/Assets

This folder covers the following endpoints:
  • get a list of all client assets
  • get a specific asset
  • create a client asset
  • update a client asset
  • delete a client asset
  • import an asset from Network Mapper
  • bulk deletion of assets
  • remove an asset from a finding
  • get a scanner output
  • get a list of affected assets
  • create affected asset status

v2/Assets

This folder covers the following endpoints:
  • retrieve a list of assets for a client (with filtering options)
  • import assets from an outside tool into PlexTrac for a specific client

v1/Clients

This folder covers the following endpoints:
  • retrieve a list of all clients
  • get object/information about a client
  • create a client
  • update a client
  • delete a client
  • add a client logo
  • delete a client logo
This folder covers the following endpoints:
  • retrieve a list of all clients (with filter and sort options)
  • retrieve a list of all users for a client
  • retrieve all findings for a specific client
  • retrieve a list of all assets for a client
This folder covers the following endpoints:
  • retrieve a list of writeups
  • retrieve a specific writeup
  • create new writeups
  • modify an existing writeup
  • delete a writeup
This folder covers the following endpoints for WriteupsDB:
  • import a repository to WriteupsDB
  • bulk copy of writeups
  • bulk move of writeups
  • bulk delete of writeups
  • bulk add tags to writeups
  • bulk addition of writeups to a report
  • move a writeup from repository to another
  • remove a writeup from a repository
  • retrieve all writeups from a repository
This folder covers the following endpoints for NarrativesDB:
  • retrieve all sections for a narrative
  • retrieve all sections for a repository
  • retrieve a specific section
  • create a NarrativesDB repository
  • create a section in a repository
  • update a section in a narrative
  • delete a section in a repository
  • list all repositories
  • copy a section to another narrative

v1/Findings

This folder covers the following endpoints:
  • get findings based on parameters
  • list all findings for a tenant
  • list all findings for a specific report
  • get a specific finding
  • create a finding
  • update a finding for a report
  • delete a finding from a report
  • get status of a specific finding for a report
  • update status of a specific finding
  • get list of findings for s specific client
  • import list of findings for a specific client

v2/Findings

This folder covers the following endpoints:
  • get findings by report
  • list affected assets by finding
  • bulk update findings
  • update evidence
  • copy finding to WriteupsDB

v1/Reports

This folder covers the following endpoints:
  • list all reports for a specific client
  • list all reports for all clients
  • get a specific report
  • create a report for a client
  • update a specific report for a client
  • delete a specific report for a client
  • get an exhibit from a report
  • upload a file to a report
  • export a report to PlexTrac

v2/Reports

This folder covers the following endpoints:
  • retrieve a list of reports for a tenant

Folder Structure on Postman

Postman folder
description
v1/v2
A set of endpoints created for PlexTrac. The first two folders (v1 and v2) are not different versions of the same endpoints but contain different API calls.
Graph QL Queries
GraphQL SELECT queries used to read or fetch values in parallel
Graph QL Mutations
GraphQL INSERT, UPDATE, and DELETE queries used to write or post values in sequence
© 2023 PlexTrac, Inc. All rights reserved.