Google

Threat Intelligence API

threatintelligence.googleapis.com API.

Developer tools#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

threatintelligence.googleapis.com API.

Endpoints 19

projects

  • POSTTriggers the generation of a Customer Profile for a project./v1beta/:name:generateOrgProfileTriggers the generation of a Customer Profile for a project.

projects.alerts

  • POSTMarks an alert as benign - BENIGN./v1beta/:name:benignMarks an alert as benign - BENIGN.
  • POSTMarks an alert as a duplicate of another alert/v1beta/:name:duplicateMarks an alert as a duplicate of another alert. - DUPLICATE.
  • GETEnumerateAlertFacets returns the facets and the number of alerts that meet the filter criteria and have that value for…/v1beta/:parent/alerts:enumerateFacets?filter=stringEnumerateAlertFacets returns the facets and the number of alerts that meet the filter criteria and have that value for each facet.
  • POSTMarks an alert as escalated - ESCALATED./v1beta/:name:escalateMarks an alert as escalated - ESCALATED.
  • POSTMarks an alert as a false positive - FALSE_POSITIVE./v1beta/:name:falsePositiveMarks an alert as a false positive - FALSE_POSITIVE.
  • GETGet the decrypted password of an alert./v1beta/:name:getPasswordGet the decrypted password of an alert.
  • GETGet a list of alerts that meet the filter criteria./v1beta/:parent/alerts?filter=string&orderBy=string&pageSize=0&pageToken=stringGet a list of alerts that meet the filter criteria.
  • POSTMarks an alert as not actionable - NOT_ACTIONABLE./v1beta/:name:notActionableMarks an alert as not actionable - NOT_ACTIONABLE.
  • POSTMarks an alert as read - READ./v1beta/:name:readMarks an alert as read - READ.
  • POSTMarks an alert to closed state - RESOLVED./v1beta/:name:resolveMarks an alert to closed state - RESOLVED.
  • POSTMarks an alert as tracked externally - TRACKED_EXTERNALLY./v1beta/:name:trackExternallyMarks an alert as tracked externally - TRACKED_EXTERNALLY.
  • POSTMarks an alert as triaged - TRIAGED./v1beta/:name:triageMarks an alert as triaged - TRIAGED.

projects.findings

  • GETGet a finding by name/v1beta/:nameGet a finding by name. The name field should have the format: projects/{project}/findings/{finding}
  • GETGet a list of findings that meet the filter criteria/v1beta/:parent/findings?filter=string&orderBy=string&pageSize=0&pageToken=stringGet a list of findings that meet the filter criteria. The parent field in ListFindingsRequest should have the format: projects/{project}
  • GETSearchFindings is a more powerful version of ListFindings that supports complex queries like "findings for alerts"…/v1beta/:parent/findings:search?orderBy=string&pageSize=0&pageToken=string&query=stringSearchFindings is a more powerful version of ListFindings that supports complex queries like "findings for alerts" using functions such as has_alert in the…

projects.configurations

  • GETGet a list of configurations that meet the filter criteria./v1beta/:parent/configurations?filter=string&orderBy=string&pageSize=0&pageToken=stringGet a list of configurations that meet the filter criteria.
  • POSTCreates or updates a configuration./v1beta/:parent/configurations:upsert?publishTime=stringCreates or updates a configuration.

projects.configurations.revisions

  • GETList configuration revisions that meet the filter criteria./v1beta/:parent/revisions?filter=string&orderBy=string&pageSize=0&pageToken=stringList configuration revisions that meet the filter criteria.

API details

Base URL
https://threatintelligence.googleapis.com
Authentication
OAuth 2.0 (authorization code flow) with 1 scope
An API key in the key query parameter
Operations
19 operations on 19 pathsPOST 11GET 8
Main resources
projects.alerts 12projects.findings 3projects.configurations 2projects 1projects.configurations.revisions 1
Response formats
application/json
Description format
Google API Discovery, API version v1beta

How to test the Threat Intelligence API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Threat Intelligence API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 1 scope. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Triggers the generation of a Customer Profile for a project.” (POST /v1beta/:name:generateOrgProfile), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Threat Intelligence API?

threatintelligence.googleapis.com API. It is listed under Developer tools and has 19 endpoints.

Who publishes the Threat Intelligence API?

It is listed from Google's public API description (an OpenAPI document), not published by Google on Swastik Codes. Anyone who controls googleapis.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Threat Intelligence API?

Requests go to https://threatintelligence.googleapis.com. Endpoint paths are added to this base URL.

How do I authenticate with the Threat Intelligence API?

It accepts 2 methods: OAuth 2.0 (authorization code flow) with 1 scope; an API key in the key query parameter.

How many endpoints does the Threat Intelligence API have?

19 operations on 19 paths (11 POST, 8 GET). The largest groups are projects.alerts, projects.findings, projects.configurations, projects.

Is forking the Threat Intelligence API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.