Using XDR APIs
Tip
The Secureworks Professional Services team is here to help you realize the full potential from your Taegis XDR investment if a higher level of support is desired. Our highly skilled consultants can help you deploy faster, optimize quicker, and accelerate your time to value. For more information, see Professional Services Overview.
API Uses ⫘
Use the Secureworks® Taegis™ XDR GraphQL Application Programming Interfaces (APIs) to interact with the platform and access your Secureworks® Taegis™ data and resources programmatically. You can use the XDR Python SDK to interface with the Taegis APIs.
API Rate Limiting ⫘
Please be aware that the Taegis platform does implement rate limiting rules for API usage. These limits vary across the application to ensure resources are available for all customers. If you receive HTTP error code 429, this indicates that the limit has been reached.
Limits are tracked per request. If you see this error, retry at a later time when the limits have reset.
Available APIs ⫘
XDR is supported by the following GraphQL APIs:
- Alerts GraphQL API
- Assets GraphQL API
- Audits GraphQL API
- Collector GraphQL API
- Playbooks GraphQL API
- Threat Intelligence GraphQL API
For more information on how to use these APIs:
- Using the Assets GraphQL API
- Using the Collector GraphQL API
- Using the Investigations GraphQL API
- Using the Automations GraphQL APIs
- Using the Threat Intelligence API
- Using the Users GraphQL API
- Using the Tenants GraphQL API
- Using the Countermeasures API
- Using the File Upload API
You can also use the XDR SDK to simplify and speed integration development with XDR:
Regions
The URL to access XDR APIs may differ according to the region your environment is deployed in:
- US1—
https://api.ctpx.secureworks.com
- US2—
https://api.delta.taegis.secureworks.com
- US3—
https://api.foxtrot.taegis.secureworks.com
- EU—
https://api.echo.taegis.secureworks.com
The examples in this XDR API documentation use https://api.ctpx.secureworks.com
throughout. If you are in a different region substitute appropriately.