{ "paths": { "/v1beta/projects/{project}/alerts/{alert}:notActionable": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "post": { "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "project", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "in": "path" }, { "schema": { "type": "string" }, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "required": true, "in": "path", "name": "alert" } ], "tags": [ "threatintelligence" ], "operationId": "MarkAlertAsNotActionable", "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Alert" } } } } }, "description": "Marks an alert as not actionable - NOT_ACTIONABLE.", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkAlertAsNotActionableRequest" } } }, "description": "The request body." } } }, "/v1beta/projects/{project}:generateOrgProfile": { "post": { "x-google-lro": "true", "tags": [ "threatintelligence" ], "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateOrgProfileConfigurationOperation" } } } } }, "operationId": "GenerateOrgProfileConfiguration", "parameters": [ { "name": "project", "schema": { "type": "string" }, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "required": true, "in": "path" } ], "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "description": "Triggers the generation of a Customer Profile for a project.", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateOrgProfileConfigurationRequest" } } }, "description": "The request body." } }, "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ] }, "/v1beta/projects/{project}/configurations/{configuration}": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "get": { "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "parameters": [ { "name": "project", "schema": { "type": "string" }, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "in": "path", "required": true }, { "schema": { "type": "string" }, "in": "path", "required": true, "name": "configuration", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122." } ], "tags": [ "threatintelligence" ], "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Configuration" } } } } }, "description": "Get a configuration by name.", "operationId": "GetConfiguration" } }, "/v1beta/projects/{project}/alerts/{alert}:getPassword": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "get": { "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPasswordResponse" } } } } }, "parameters": [ { "in": "path", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "schema": { "type": "string" }, "required": true, "name": "project" }, { "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "required": true, "in": "path", "name": "alert", "schema": { "type": "string" } } ], "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "tags": [ "threatintelligence" ], "description": "Get the decrypted password of an alert.", "operationId": "GetPassword" } }, "/v1beta/projects/{project}/configurations/{configuration}/revisions": { "get": { "responses": { "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListConfigurationRevisionsResponse" } } }, "description": "Successful operation" } }, "description": "List configuration revisions that meet the filter criteria.", "operationId": "ListConfigurationRevisions", "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "parameters": [ { "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "name": "project", "in": "path", "schema": { "type": "string" }, "required": true }, { "required": true, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "schema": { "type": "string" }, "name": "configuration", "in": "path" }, { "schema": { "type": "string" }, "description": "Optional. An AIP-160 filter string", "in": "query", "name": "filter" }, { "description": "Optional. Specify ordering of response", "schema": { "type": "string" }, "name": "orderBy", "in": "query" }, { "name": "pageSize", "schema": { "format": "int32", "type": "integer" }, "in": "query", "description": "Optional. Page Size" }, { "name": "pageToken", "description": "Optional. A page token provided by the API", "schema": { "type": "string" }, "in": "query" } ], "tags": [ "threatintelligence" ] }, "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ] }, "/v1beta/projects/{project}/configurations:upsert": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "post": { "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpsertConfigurationResponse" } } } } }, "description": "Creates or updates a configuration.", "requestBody": { "description": "Required. Configuration we are creating or updating.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Configuration" } } } }, "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "operationId": "UpsertConfiguration", "parameters": [ { "name": "project", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "schema": { "type": "string" }, "required": true, "in": "path" }, { "description": "Optional. Time that the configuration should be considered to have been published.\nThis is an advanced feature used when onboarding and bulk loading data from\nother systems. Do not set this field without consulting with the API team.", "name": "publishTime", "in": "query", "schema": { "format": "date-time", "type": "string" } } ], "tags": [ "threatintelligence" ] } }, "/v1beta/projects/{project}/alerts/{alert}:benign": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "post": { "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Alert" } } } } }, "tags": [ "threatintelligence" ], "operationId": "MarkAlertAsBenign", "description": "Marks an alert as benign - BENIGN.", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkAlertAsBenignRequest" } } }, "description": "The request body." }, "parameters": [ { "required": true, "in": "path", "name": "project", "schema": { "type": "string" }, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122." }, { "schema": { "type": "string" }, "required": true, "name": "alert", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "in": "path" } ] } }, "/v1beta/projects/{project}/alerts/{alert}:trackExternally": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "name": "project", "in": "path" }, { "name": "alert", "schema": { "type": "string" }, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "in": "path", "required": true } ], "operationId": "MarkAlertAsTrackedExternally", "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Alert" } } } } }, "description": "Marks an alert as tracked externally - TRACKED_EXTERNALLY.", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkAlertAsTrackedExternallyRequest" } } }, "description": "The request body." }, "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "tags": [ "threatintelligence" ] } }, "/v1beta/projects/{project}/alerts/{alert}:read": { "post": { "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "parameters": [ { "in": "path", "required": true, "name": "project", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "schema": { "type": "string" } }, { "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "schema": { "type": "string" }, "name": "alert", "required": true, "in": "path" } ], "responses": { "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Alert" } } }, "description": "Successful operation" } }, "description": "Marks an alert as read - READ.", "requestBody": { "description": "The request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkAlertAsReadRequest" } } } }, "tags": [ "threatintelligence" ], "operationId": "MarkAlertAsRead" }, "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ] }, "/v1beta/projects/{project}/alerts/{alert}/documents/{document}": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "get": { "parameters": [ { "required": true, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "in": "path", "name": "project", "schema": { "type": "string" } }, { "name": "alert", "required": true, "schema": { "type": "string" }, "in": "path", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122." }, { "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "in": "path", "required": true, "schema": { "type": "string" }, "name": "document" } ], "responses": { "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertDocument" } } }, "description": "Successful operation" } }, "description": "Gets a specific document associated with an alert.", "operationId": "GetAlertDocument", "tags": [ "threatintelligence" ], "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ] } }, "/v1beta/projects/{project}/configurations": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "get": { "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "parameters": [ { "name": "project", "required": true, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "in": "path", "schema": { "type": "string" } }, { "name": "filter", "description": "Optional. Filter criteria.", "schema": { "type": "string" }, "in": "query" }, { "name": "orderBy", "in": "query", "description": "Optional. Order by criteria in the csv format: \"field1,field2 desc\" or\n\"field1,field2\" or \"field1 asc, field2\".", "schema": { "type": "string" } }, { "description": "Optional. Page token.", "in": "query", "schema": { "type": "string" }, "name": "pageToken" }, { "description": "Optional. Page size.", "name": "pageSize", "schema": { "type": "integer", "format": "int32" }, "in": "query" } ], "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListConfigurationsResponse" } } } } }, "description": "Get a list of configurations that meet the filter criteria.", "operationId": "ListConfigurations", "tags": [ "threatintelligence" ] } }, "/v1beta/projects/{project}/findings": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "get": { "parameters": [ { "schema": { "type": "string" }, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "required": true, "name": "project", "in": "path" }, { "in": "query", "schema": { "type": "string" }, "description": "Optional. Filter criteria.", "name": "filter" }, { "in": "query", "description": "Optional. Order by criteria in the csv format: \"field1,field2 desc\" or\n\"field1,field2\" or \"field1 asc, field2\".", "name": "orderBy", "schema": { "type": "string" } }, { "in": "query", "name": "pageToken", "schema": { "type": "string" }, "description": "Optional. Page token." }, { "schema": { "format": "int32", "type": "integer" }, "in": "query", "name": "pageSize", "description": "Optional. Page size." } ], "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "operationId": "ListFindings", "tags": [ "threatintelligence" ], "description": "Get a list of findings that meet the filter criteria.\nThe `parent` field in ListFindingsRequest should have the format:\nprojects/{project}", "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListFindingsResponse" } } } } } } }, "/v1beta/projects/{project}/findings/{finding}": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "get": { "operationId": "GetFinding", "description": "Get a finding by name.\nThe `name` field should have the format:\n`projects/{project}/findings/{finding}`", "parameters": [ { "in": "path", "required": true, "schema": { "type": "string" }, "name": "project", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122." }, { "in": "path", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "schema": { "type": "string" }, "required": true, "name": "finding" } ], "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Finding" } } } } }, "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "tags": [ "threatintelligence" ] } }, "/v1beta/projects/{project}/alerts/{alert}:triage": { "post": { "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Alert" } } } } }, "parameters": [ { "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "in": "path", "schema": { "type": "string" }, "required": true, "name": "project" }, { "in": "path", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "schema": { "type": "string" }, "name": "alert", "required": true } ], "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "tags": [ "threatintelligence" ], "description": "Marks an alert as triaged - TRIAGED.", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkAlertAsTriagedRequest" } } }, "description": "The request body." }, "operationId": "MarkAlertAsTriaged" }, "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ] }, "/v1beta/projects/{project}/alerts/{alert}:falsePositive": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "post": { "operationId": "MarkAlertAsFalsePositive", "description": "Marks an alert as a false positive - FALSE_POSITIVE.", "requestBody": { "description": "The request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkAlertAsFalsePositiveRequest" } } } }, "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Alert" } } } } }, "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "tags": [ "threatintelligence" ], "parameters": [ { "name": "project", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "schema": { "type": "string" }, "required": true, "in": "path" }, { "in": "path", "required": true, "name": "alert", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "schema": { "type": "string" } } ] } }, "/v1beta/projects/{project}/alerts/{alert}": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "get": { "description": "Get an alert by name.", "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "parameters": [ { "in": "path", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "required": true, "schema": { "type": "string" }, "name": "project" }, { "in": "path", "name": "alert", "required": true, "schema": { "type": "string" }, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122." } ], "tags": [ "threatintelligence" ], "operationId": "GetAlert", "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Alert" } } } } } } }, "/v1beta/projects/{project}/alerts/{alert}:escalate": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "post": { "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Alert" } } } } }, "tags": [ "threatintelligence" ], "operationId": "MarkAlertAsEscalated", "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "description": "Marks an alert as escalated - ESCALATED.", "requestBody": { "description": "The request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkAlertAsEscalatedRequest" } } } }, "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "project", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "in": "path" }, { "name": "alert", "in": "path", "schema": { "type": "string" }, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "required": true } ] } }, "/v1beta/projects/{project}/alerts": { "get": { "tags": [ "threatintelligence" ], "parameters": [ { "required": true, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "schema": { "type": "string" }, "in": "path", "name": "project" }, { "description": "Optional. Filter criteria.\n\nSupported fields for filtering include:\n\n* `audit.create_time`\n* `audit.creator`\n* `audit.update_time`\n* `audit.updater`\n* `detail.data_leak.discovery_document_ids`\n* `detail.data_leak.severity`\n* `detail.detail_type`\n* `detail.initial_access_broker.discovery_document_ids`\n* `detail.initial_access_broker.severity`\n* `detail.insider_threat.discovery_document_ids`\n* `detail.insider_threat.severity`\n* `finding_count`\n* `priority_analysis.priority_level`\n* `relevance_analysis.confidence`\n* `relevance_analysis.relevance_level`\n* `relevance_analysis.relevant`\n* `severity_analysis.severity_level`\n* `state`\n\nExamples:\n\n* `detail.detail_type = \"initial_access_broker\"`\n* `detail.detail_type != \"data_leak\"`\n* `detail.insider_threat.severity = \"HIGH\"`\n* `audit.create_time \u003e= \"2026-04-03T00:00:00Z\" AND audit.create_time \u003c\n\"2026-04-06T00:00:00Z\"`\n* `state = \"NEW\" OR state = \"TRIAGED\"`\n* `severity_analysis.severity_level = \"SEVERITY_LEVEL_CRITICAL\"`", "in": "query", "name": "filter", "schema": { "type": "string" } }, { "in": "query", "description": "Optional. Order by criteria in the csv format: \"field1, field2 desc\" or\n\"field1, field2\" or \"field1 asc, field2\". If a field is specified without\n`asc` or `desc`, ascending order is used by default. Supported fields for\nordering are identical to those supported for filtering.\n\nExamples:\n\n* `audit.create_time desc`\n* `audit.update_time asc`\n* `audit.create_time desc, severity_analysis.severity_level desc`", "schema": { "type": "string" }, "name": "orderBy" }, { "in": "query", "schema": { "type": "string" }, "name": "pageToken", "description": "Optional. Page token to retrieve the next page of results." }, { "schema": { "type": "integer", "format": "int32" }, "description": "Optional. Page size. Default to 100 alerts per page. Maximum is 1000 alerts per page.", "in": "query", "name": "pageSize" } ], "operationId": "ListAlerts", "description": "Get a list of alerts that meet the filter criteria.", "responses": { "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListAlertsResponse" } } }, "description": "Successful operation" } }, "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ] }, "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ] }, "/v1beta/projects/{project}/findings:search": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "get": { "parameters": [ { "in": "path", "required": true, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "schema": { "type": "string" }, "name": "project" }, { "schema": { "type": "string" }, "name": "query", "description": "Optional. Query on what findings will be returned. This supports the same filter\ncriteria as FindingService.ListFindings as well as the following\nrelationship query `has_alert`.\nExample:\n - `has_alert(\"name=\\\"projects/gti-12345/alerts/alert-12345\\\"\")`", "in": "query" }, { "name": "orderBy", "in": "query", "description": "Optional. Order by criteria in the csv format: \"field1,field2 desc\" or\n\"field1,field2\" or \"field1 asc, field2\".", "schema": { "type": "string" } }, { "name": "pageToken", "in": "query", "description": "Optional. Page token.", "schema": { "type": "string" } }, { "name": "pageSize", "in": "query", "description": "Optional. Page size.", "schema": { "format": "int32", "type": "integer" } } ], "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchFindingsResponse" } } } } }, "tags": [ "threatintelligence" ], "description": "SearchFindings is a more powerful version of ListFindings that\nsupports complex queries like \"findings for alerts\" using functions such as\n`has_alert` in the query string.\nThe `parent` field in SearchFindingsRequest should have the format:\nprojects/{project}\nExample to search for findings for a specific issue:\n`has_alert(\"name=\\\"projects/gti-12345/alerts/alert-12345\\\"\")`", "operationId": "SearchFindings" } }, "/v1beta/projects/{project}/alerts/{alert}:duplicate": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "post": { "responses": { "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Alert" } } }, "description": "Successful operation" } }, "description": "Marks an alert as a duplicate of another alert. - DUPLICATE.", "requestBody": { "description": "The request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkAlertAsDuplicateRequest" } } } }, "parameters": [ { "in": "path", "schema": { "type": "string" }, "name": "project", "required": true, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122." }, { "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "in": "path", "name": "alert", "required": true, "schema": { "type": "string" } } ], "operationId": "MarkAlertAsDuplicate", "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "tags": [ "threatintelligence" ] } }, "/v1beta/projects/{project}/alerts:enumerateFacets": { "get": { "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "tags": [ "threatintelligence" ], "operationId": "EnumerateAlertFacets", "description": "EnumerateAlertFacets returns the facets and the number of alerts that meet\nthe filter criteria and have that value for each facet.", "responses": { "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnumerateAlertFacetsResponse" } } }, "description": "Successful operation" } }, "parameters": [ { "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "name": "project", "required": true, "schema": { "type": "string" }, "in": "path" }, { "description": "Optional. Filter on what alerts will be enumerated.", "in": "query", "name": "filter", "schema": { "type": "string" } } ] }, "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ] }, "/v1beta/projects/{project}/alerts/{alert}:resolve": { "parameters": [ { "$ref": "#/components/parameters/alt" }, { "$ref": "#/components/parameters/callback" }, { "$ref": "#/components/parameters/prettyPrint" }, { "$ref": "#/components/parameters/_.xgafv" } ], "post": { "security": [ { "google_oauth_implicit": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "google_oauth_code": [ "https://www.googleapis.com/auth/cloud-platform" ] }, { "bearer_auth": [] } ], "parameters": [ { "schema": { "type": "string" }, "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "required": true, "in": "path", "name": "project" }, { "schema": { "type": "string" }, "name": "alert", "description": "Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.", "required": true, "in": "path" } ], "operationId": "MarkAlertAsResolved", "description": "Marks an alert to closed state - RESOLVED.", "requestBody": { "description": "The request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkAlertAsResolvedRequest" } } } }, "tags": [ "threatintelligence" ], "responses": { "default": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Alert" } } } } } } } }, "externalDocs": { "url": "https://docs.cloud.google.com/threatintelligence/", "description": "Find more info here." }, "servers": [ { "description": "Global Endpoint", "url": "https://threatintelligence.googleapis.com" }, { "x-google-endpoint-location": "us-central1", "url": "https://threatintelligence.us-central1.rep.googleapis.com/", "description": "Regional Endpoint" } ], "info": { "title": "Threat Intelligence API", "x-google-revision": "20260830", "description": "threatintelligence.googleapis.com API.", "version": "v1beta" }, "openapi": "3.0.3", "components": { "parameters": { "alt": { "schema": { "type": "string", "default": "json", "x-google-enum-descriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "enum": [ "json", "media", "proto" ] }, "name": "$alt", "in": "query", "description": "Data format for response." }, "_.xgafv": { "schema": { "x-google-enum-descriptions": [ "v1 error format", "v2 error format" ], "type": "string", "enum": [ "1", "2" ] }, "name": "$.xgafv", "description": "V1 error format.", "in": "query" }, "prettyPrint": { "name": "$prettyPrint", "in": "query", "schema": { "type": "boolean", "default": "true" }, "description": "Returns response with indentations and line breaks." }, "callback": { "description": "JSONP", "in": "query", "name": "$callback", "schema": { "type": "string" } } }, "securitySchemes": { "bearer_auth": { "scheme": "bearer", "type": "http", "description": "Http bearer authentication." }, "google_oauth_implicit": { "flows": { "implicit": { "authorizationUrl": "https://accounts.google.com/o/oauth2/v2/auth", "scopes": { "https://www.googleapis.com/auth/cloud-platform": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." } } }, "type": "oauth2", "description": "Google Oauth 2.0 implicit authentication flow." }, "google_oauth_code": { "flows": { "authorizationCode": { "authorizationUrl": "https://accounts.google.com/o/oauth2/v2/auth", "scopes": { "https://www.googleapis.com/auth/cloud-platform": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." }, "tokenUrl": "https://oauth2.googleapis.com/token", "refreshUrl": "https://oauth2.googleapis.com/token" } }, "description": "Google Oauth 2.0 authorizationCode authentication flow.", "type": "oauth2" } }, "schemas": { "CustomerProfileSecurityConsiderations": { "properties": { "considerations": { "items": { "type": "string" }, "type": "array", "description": "Optional. A series of considerations for the security of the organization,\nsuch as \"high risk of compromise\" or \"vulnerable to cyberbullying\"." }, "note": { "type": "string", "description": "Optional. A note about the security considerations." } }, "description": "Security considerations for the customer profile.", "type": "object" }, "CustomerProfileWebPresence": { "properties": { "domain": { "description": "Required. The domain name of the web presence.", "type": "string" }, "citationIds": { "items": { "type": "string" }, "type": "array", "description": "Optional. The citation ids for the web presence." } }, "type": "object", "required": [ "domain" ], "description": "Web presence information for the customer profile." }, "GenerateOrgProfileConfigurationOperation": { "description": "This resource represents a long-running operation where metadata and response fields are strongly typed.", "allOf": [ { "$ref": "#/components/schemas/BaseOperation" }, { "type": "object", "properties": { "metadata": { "$ref": "#/components/schemas/OperationMetadata" }, "response": { "$ref": "#/components/schemas/Configuration" } } } ], "type": "object" }, "ProductFix": { "required": [ "displayName", "sourceId" ], "description": "Contains details about a product fix.", "properties": { "displayName": { "description": "Required. The name of the fix. Ex: \"Magento\".", "type": "string" }, "sourceId": { "type": "string", "description": "Required. The source ID of the fix. Ex: \"APPSEC-1420\"." }, "uri": { "type": "string", "description": "Optional. The URI of the fix." }, "publishTime": { "type": "string", "format": "date-time", "description": "Optional. The published time of the fix." } }, "type": "object" }, "Finding": { "type": "object", "properties": { "provider": { "description": "Required. Logical source of this finding (name of the sub-engine).", "type": "string" }, "relevanceAnalysis": { "description": "Output only. High-Precision Relevance Analysis verdict for the finding.", "readOnly": true, "allOf": [ { "$ref": "#/components/schemas/RelevanceAnalysis" } ] }, "reoccurrenceTimes": { "items": { "format": "date-time", "type": "string" }, "readOnly": true, "description": "Output only. When identical finding (same labels and same details) has re-occurred.", "type": "array" }, "name": { "description": "Identifier. Server generated name for the finding (leave clear during creation).\nFormat: projects/{project}/findings/{finding}", "x-google-identifier": true, "type": "string" }, "displayName": { "type": "string", "description": "Required. A short descriptive title for the finding \u003c= 250 chars.\nEX: \"Actor 'baddy' offering $1000 for credentials of 'goodguy'\"." }, "severityAnalysis": { "readOnly": true, "allOf": [ { "$ref": "#/components/schemas/SeverityAnalysis" } ], "description": "Output only. High-Precision Severity Analysis verdict for the finding." }, "alert": { "type": "string", "description": "Optional. Name of the alert that this finding is bound to." }, "aiSummary": { "type": "string", "description": "Optional. AI summary of the finding." }, "severity": { "description": "Optional. Deprecated: Use the `severity_analysis` field instead.\nBase severity score from the finding source.", "deprecated": true, "type": "number", "format": "float" }, "configurations": { "items": { "type": "string" }, "description": "Optional. Configuration names that are bound to this finding.", "type": "array" }, "audit": { "readOnly": true, "allOf": [ { "$ref": "#/components/schemas/Audit" } ], "description": "Output only. Audit data about the finding." }, "detail": { "allOf": [ { "$ref": "#/components/schemas/FindingDetail" } ], "description": "Required. Holder of the domain specific details of the finding." } }, "description": "A ‘stateless’ and a point in time event that a check produced a result\nof interest.", "required": [ "provider", "displayName", "detail" ] }, "CustomerProfilePerson": { "description": "Person information for the customer profile.", "required": [ "name" ], "properties": { "name": { "description": "Required. The name of the person.", "type": "string" }, "citationIds": { "items": { "type": "string" }, "type": "array", "description": "Optional. The citation ids for the person." }, "title": { "description": "Optional. The title of the person.", "type": "string" } }, "type": "object" }, "MarkAlertAsBenignRequest": { "description": "Request message for MarkAlertAsBenign.", "type": "object" }, "InsiderThreatFindingDetail": { "properties": { "matchScore": { "type": "number", "format": "float", "description": "Required. Reference to the match score of the InsiderThreat finding. This is a float\nvalue greater than 0 and less than or equal to 1 calculated by the matching\nengine based on the similarity of the document and the user provided\nconfigurations." }, "documentId": { "description": "Required. The unique identifier of the document that triggered the InsiderThreat\nfinding. This ID can be used to retrieve the content of the document for\nfurther analysis.", "type": "string" }, "severity": { "enum": [ "SEVERITY_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "CRITICAL" ], "description": "Required. The severity of the InsiderThreat finding. This indicates the potential\nimpact of the threat.", "x-google-enum-descriptions": [ "Default value, should never be set.", "Low severity.", "Medium severity.", "High severity.", "Critical severity." ], "type": "string" } }, "required": [ "matchScore", "severity", "documentId" ], "description": "A detail object for a InsiderThreat finding.", "type": "object" }, "DomainConfiguration": { "type": "object", "description": "Configuration holding settings for one or more monitored domains.", "properties": { "domainSettings": { "type": "array", "description": "Optional. A list of settings for individual domains.", "items": { "$ref": "#/components/schemas/DomainSetting" } } } }, "PriorityLevel": { "x-google-enum-descriptions": [ "Default value, should never be set.", "Low Priority.", "Medium Priority.", "High Priority.", "Critical Priority." ], "enum": [ "PRIORITY_LEVEL_UNSPECIFIED", "PRIORITY_LEVEL_LOW", "PRIORITY_LEVEL_MEDIUM", "PRIORITY_LEVEL_HIGH", "PRIORITY_LEVEL_CRITICAL" ], "type": "string" }, "Operation": { "description": "This resource represents a long-running operation that is the result of a\nnetwork API call.", "type": "object", "allOf": [ { "$ref": "#/components/schemas/BaseOperation" }, { "type": "object", "properties": { "metadata": { "description": "Service-specific metadata associated with the operation. It typically\ncontains progress information and common metadata such as create time.\nSome services might not provide such metadata. Any method that returns a\nlong-running operation should document the metadata type, if any.", "type": "object", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL." } }, "response": { "type": "object", "description": "The normal, successful response of the operation. If the original\nmethod returns no data on success, such as `Delete`, the response is\n`google.protobuf.Empty`. If the original method is standard\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmethods, the response should have the type `XxxResponse`, where `Xxx`\nis the original method name. For example, if the original method name\nis `TakeSnapshot()`, the inferred response type is\n`TakeSnapshotResponse`.", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL." } } } } ] }, "Evidence": { "type": "object", "properties": { "commonThemes": { "items": { "type": "string" }, "type": "array", "description": "A list of semantic themes or concepts found to be common, related, or\naligned between the sources, supporting the verdict." }, "distinctThemes": { "description": "A list of semantic themes or descriptions unique to one source or\nsemantically distant.", "type": "array", "items": { "type": "string" } } }, "description": "Details the evidence used to determine the relevance verdict." }, "MarkAlertAsEscalatedRequest": { "type": "object", "description": "Request message for MarkAlertAsEscalated." }, "SearchFindingsResponse": { "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "Page token." }, "findings": { "type": "array", "description": "List of findings.", "items": { "$ref": "#/components/schemas/Finding" } } }, "description": "Response message for SearchFindings." }, "AlertDetail": { "type": "object", "description": "Container for different types of alert details.", "properties": { "initialAccessBroker": { "allOf": [ { "$ref": "#/components/schemas/InitialAccessBrokerAlertDetail" } ], "description": "Initial Access Broker alert detail type." }, "detailType": { "description": "Output only. Name of the detail type. Will be set by the server during creation to the\nname of the field that is set in the detail union.", "readOnly": true, "type": "string" }, "targetTechnology": { "description": "Technology Watchlist alert detail type.", "allOf": [ { "$ref": "#/components/schemas/TargetTechnologyAlertDetail" } ] }, "insiderThreat": { "description": "Insider Threat alert detail type.", "allOf": [ { "$ref": "#/components/schemas/InsiderThreatAlertDetail" } ] }, "dataLeak": { "description": "Data Leak alert detail type.", "allOf": [ { "$ref": "#/components/schemas/DataLeakAlertDetail" } ] } } }, "PublicExploit": { "required": [ "exploitName" ], "properties": { "uri": { "type": "string", "description": "Optional. The URI of the exploit." }, "exploitGrade": { "description": "Optional. The grade of the exploit. Ex: \"non-weaponized\".", "type": "string", "enum": [ "EXPLOIT_GRADE_UNSPECIFIED", "UNEVALUATED", "PROOF_OF_CONCEPT", "NON_WEAPONIZED", "WEAPONIZED", "SCANNER", "FAKE" ], "x-google-enum-descriptions": [ "Unspecified exploit grade.", "Unevaluated exploit grade.", "Proof-of-concept exploit grade.", "Non-weaponized exploit grade.", "Weaponized exploit grade.", "Scanner exploit grade.", "Fake exploit grade." ] }, "exploitName": { "description": "Required. The name of the exploit. Ex: \"Magentounauth.php.txt\".", "type": "string" }, "releaseTime": { "type": "string", "description": "Optional. The release time of the exploit.", "format": "date-time" }, "exploitReliability": { "type": "string", "x-google-enum-descriptions": [ "Unspecified exploit reliability.", "Confirmed exploit reliability.", "Uncorroborated exploit reliability.", "Unconfirmed exploit reliability." ], "enum": [ "EXPLOIT_RELIABILITY_UNSPECIFIED", "UNREVIEWED", "REVIEWED", "TESTED" ], "description": "Optional. The reliability of the exploit. Ex: \"Unreviewed\"." }, "sizeBytes": { "description": "Optional. The size of the exploit.", "format": "int64", "type": "string" } }, "description": "Contains details about a public exploit.", "type": "object" }, "CustomerProfileCitedString": { "description": "A string with citation ids.", "required": [ "value" ], "properties": { "value": { "type": "string", "description": "Required. The value of the string." }, "citationIds": { "description": "Optional. The citation ids for the string.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "MarkAlertAsFalsePositiveRequest": { "description": "Request message for MarkAlertAsFalsePositive.", "type": "object" }, "DataLeakFindingDetail": { "description": "A detail object for a Data Leak finding.", "required": [ "matchScore", "severity", "documentId" ], "type": "object", "properties": { "severity": { "description": "Required. The severity of the Data Leak finding. This indicates the potential\nimpact of the threat.", "type": "string", "x-google-enum-descriptions": [ "Default value, should never be set.", "Low severity.", "Medium severity.", "High severity.", "Critical severity." ], "enum": [ "SEVERITY_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "CRITICAL" ] }, "matchScore": { "description": "Required. Reference to the match score of the Data Leak finding. This is a float\nvalue greater than 0 and less than or equal to 1 calculated by the matching\nengine based on the similarity of the document and the user provided\nconfigurations.", "format": "float", "type": "number" }, "documentId": { "type": "string", "description": "Required. The unique identifier of the document that triggered the Data Leak finding.\nThis ID can be used to retrieve the content of the document for further\nanalysis." } } }, "InitialAccessBrokerAlertDetail": { "properties": { "discoveryDocumentIds": { "type": "array", "items": { "type": "string" }, "description": "Required. Array of ids to accommodate multiple discovery documents" }, "severity": { "description": "Required. The severity of the Initial Access Broker (IAB) alert.\nAllowed values are:\n* `LOW`\n* `MEDIUM`\n* `HIGH`\n* `CRITICAL`", "type": "string" } }, "required": [ "severity", "discoveryDocumentIds" ], "type": "object", "description": "Captures the specific details of InitialAccessBroker (IAB) alert." }, "Status": { "type": "object", "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).", "properties": { "details": { "type": "array", "items": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" }, "description": "A list of messages that carry the error details. There is a common set of\nmessage types for APIs to use." }, "code": { "type": "integer", "format": "int32", "description": "The status code, which should be an enum value of google.rpc.Code." }, "message": { "type": "string", "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client." } } }, "ConfigurationDetail": { "properties": { "customThreatScenario": { "description": "Custom Threat Scenario detail config.", "allOf": [ { "$ref": "#/components/schemas/CustomThreatScenarioConfig" } ] }, "technologyWatchlist": { "allOf": [ { "$ref": "#/components/schemas/TechnologyWatchListConfig" } ], "description": "Technology Watchlist detail config." }, "detailType": { "type": "string", "description": "Output only. Name of the detail type. Will be set by the server during creation to the\nname of the field that is set in the detail union.", "readOnly": true }, "customerProfile": { "description": "Customer Profile detail config.", "allOf": [ { "$ref": "#/components/schemas/CustomerProfileConfig" } ] }, "domainConfiguration": { "description": "Domain Configuration detail config.", "allOf": [ { "$ref": "#/components/schemas/DomainConfiguration" } ] } }, "type": "object", "description": "Wrapper class that contains the union struct for all the various\nconfiguration detail specific classes." }, "SeverityLevel": { "type": "string", "x-google-enum-descriptions": [ "Default value, should never be set.", "Low Severity.", "Medium Severity.", "High Severity." ], "enum": [ "SEVERITY_LEVEL_UNSPECIFIED", "SEVERITY_LEVEL_LOW", "SEVERITY_LEVEL_MEDIUM", "SEVERITY_LEVEL_HIGH" ] }, "ExploitationState": { "enum": [ "EXPLOITATION_STATE_UNSPECIFIED", "EXPLOITATION_STATE_NO_KNOWN", "EXPLOITATION_STATE_REPORTED", "EXPLOITATION_STATE_SUSPECTED", "EXPLOITATION_STATE_CONFIRMED", "EXPLOITATION_STATE_WIDESPREAD" ], "type": "string", "x-google-enum-descriptions": [ "Unspecified exploitation state.", "No known exploitation.", "Exploitation has been reported.", "Exploitation is suspected.", "Exploitation is confirmed.", "Widespread exploitation." ] }, "ListAlertsResponse": { "properties": { "nextPageToken": { "type": "string", "description": "Page token." }, "alerts": { "type": "array", "description": "List of alerts.", "items": { "$ref": "#/components/schemas/Alert" } } }, "description": "Response message for ListAlerts.", "type": "object" }, "MarkAlertAsReadRequest": { "description": "Request message for MarkAlertAsRead.", "type": "object" }, "MarkAlertAsTrackedExternallyRequest": { "description": "Request message for MarkAlertAsTrackedExternally.", "type": "object" }, "VulnerabilityMatch": { "type": "object", "properties": { "technologies": { "type": "array", "items": { "type": "string" }, "description": "Required. All technologies affected by the vulnerability. Ex: \"Apache Struts\"." }, "cvss3Score": { "description": "Required. The CVSS score of the vulnerability. Evaluates to CVSS v3 when available\nwith a fallback to v2 and v4. Example: 6.4.", "type": "number", "format": "float" }, "productFixes": { "description": "Optional. List of product fixes for the vulnerability.", "type": "array", "items": { "$ref": "#/components/schemas/ProductFix" } }, "exploitationConsequences": { "type": "array", "description": "Optional. List of exploitation consequences for the vulnerability.", "items": { "enum": [ "EXPLOITATION_CONSEQUENCE_UNSPECIFIED", "CODE_EXECUTION", "COMMAND_EXECUTION", "DATA_LOSS", "DATA_MANIPULATION", "DENIAL_OF_SERVICE", "INFORMATION_DISCLOSURE", "UNAUTHORIZED_ACCESS", "PRIVILEGE_ESCALATION", "SANDBOX_ESCAPE", "SECURITY_BYPASS", "CONTAINER_ESCAPE", "SPOOFING" ], "type": "string", "x-google-enum-descriptions": [ "Unspecified exploitation consequence.", "Code execution consequence.", "Command execution consequence.", "Data loss consequence.", "Data manipulation consequence.", "Denial-of-Service consequence.", "Information disclosure consequence.", "Unauthorized access consequence.", "Privilege escalation consequence.", "Sandbox escape consequence.", "Security bypass consequence.", "Container escape consequence.", "Spoofing consequence." ] } }, "exploitationState": { "allOf": [ { "$ref": "#/components/schemas/ExploitationState" } ], "description": "Required. The exploitation state of the vulnerability." }, "associations": { "type": "array", "items": { "$ref": "#/components/schemas/Association" }, "description": "Optional. Associated threat actors, malware, etc. This is embedded as a snapshot\nbecause the details of the association at the time of the vulnerability\nmatch are important for context and reporting." }, "priority": { "description": "Optional. The priority level of the vulnerability data. Ex: \"P1\".", "enum": [ "PRIORITY_UNSPECIFIED", "P0", "P1", "P2", "P3", "P4" ], "x-google-enum-descriptions": [ "Unspecified priority.", "Priority level 0.", "Priority level 1.", "Priority level 2.", "Priority level 3.", "Priority level 4." ], "type": "string" }, "publicExploits": { "description": "Optional. List of public exploits.", "items": { "$ref": "#/components/schemas/PublicExploit" }, "type": "array" }, "matchedTechnologies": { "items": { "type": "string" }, "description": "Optional. The specific technologies from the configured watchlist that triggered the\nmatch. Ex: \"Apache Struts\".", "type": "array" }, "disclosureTime": { "type": "string", "format": "date-time", "description": "Optional. The disclosure time of the vulnerability." }, "epssScore": { "format": "float", "description": "Optional. The EPSS score, representing the probability of exploitation. Example:\n0.87.", "type": "number" }, "riskRating": { "description": "Required. The risk rating of the vulnerability.", "type": "string", "x-google-enum-descriptions": [ "Unspecified risk rating. This is the default value when the risk rating\nis not set.", "Low risk rating.", "Medium risk rating.", "High risk rating.", "Critical risk rating.", "The vulnerability has been assessed, but a specific risk rating could\nnot be determined or assigned." ], "enum": [ "RISK_RATING_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "CRITICAL", "UNRATED" ] }, "cveId": { "description": "Required. The CVE ID of the vulnerability. Ex: \"CVE-2025-9876\".\nSee https://www.cve.org/ for more information.", "type": "string" }, "publiclyAvailableExploit": { "description": "Output only. Whether a publicly available exploit exists.", "readOnly": true, "type": "boolean" }, "exploitationVectors": { "type": "array", "description": "Optional. List of exploitation vectors for the vulnerability.", "items": { "enum": [ "EXPLOITATION_VECTOR_UNSPECIFIED", "ADMINISTRATIVE_INTERFACE", "BLUETOOTH_ACCESS", "BROWSER", "COMPROMISED_COMMUNICATION_CHANNEL", "EMAIL", "EXPOSED_WEB_APPLICATION", "LOCAL_NETWORK_ACCESS", "MALICIOUS_APPLICATION", "MALICIOUS_FILE", "MALICIOUS_SERVER", "OPEN_PORT", "PHYSICAL_ACCESS", "SHORT_RANGE_RADIO", "UNSPECIFIED_LOCAL_VECTOR", "UNSPECIFIED_REMOTE_VECTOR", "VPN_ACCESS", "WIFI_ACCESS" ], "x-google-enum-descriptions": [ "Unspecified exploitation vector.", "Administrative interface vector.", "Bluetooth access vector.", "Browser vector.", "Compromised communication channel vector.", "Email vector.", "Exposed web application vector.", "Local network access vector.", "Malicious application vector.", "Malicious file vector.", "Malicious server vector.", "Open port vector.", "Physical access vector.", "Short range radio vector.", "Unspecified local vector.", "Unspecified remote vector.", "VPN access vector.", "WiFi access vector." ], "type": "string" } }, "collectionId": { "description": "Required. The collection ID of the vulnerability.\nEx: \"vulnerability--cve-2025-9876\".", "type": "string" }, "description": { "description": "Required. A description of the vulnerability.", "type": "string" } }, "required": [ "cveId", "collectionId", "description", "technologies", "cvss3Score", "riskRating", "exploitationState" ], "description": "Contains details about a vulnerability match." }, "BaseOperation": { "properties": { "name": { "description": "The server-assigned name, which is only unique within the same service that\noriginally returns it. If you use the default HTTP mapping, the\n`name` should be a resource name ending with `operations/{unique_id}`.", "type": "string" }, "done": { "type": "boolean", "description": "If the value is `false`, it means the operation is still in progress.\nIf `true`, the operation is completed, and either `error` or `response` is\navailable." }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "allOf": [ { "$ref": "#/components/schemas/Status" } ] } }, "description": "This resource represents a long-running operation that is the result of a\nnetwork API call.", "type": "object" }, "TargetTechnologyFindingDetail": { "description": "Contains details for a technology watchlist finding.", "properties": { "vulnerabilityMatch": { "allOf": [ { "$ref": "#/components/schemas/VulnerabilityMatch" } ], "description": "Optional. The vulnerability match details." } }, "type": "object" }, "InsiderThreatAlertDetail": { "required": [ "severity", "discoveryDocumentIds" ], "type": "object", "description": "Captures the specific details of InsiderThreat alert.", "properties": { "severity": { "description": "Required. The severity of the Insider Threat alert.\nAllowed values are:\n* `LOW`\n* `MEDIUM`\n* `HIGH`\n* `CRITICAL`", "type": "string" }, "discoveryDocumentIds": { "type": "array", "items": { "type": "string" }, "description": "Required. Array of ids to accommodate multiple discovery documents" } } }, "DataLeakAlertDetail": { "required": [ "severity", "discoveryDocumentIds" ], "description": "Captures the specific details of Data Leak alert.", "type": "object", "properties": { "severity": { "description": "Required. The severity of the Data Leak alert.\nAllowed values are:\n* `LOW`\n* `MEDIUM`\n* `HIGH`\n* `CRITICAL`", "type": "string" }, "discoveryDocumentIds": { "items": { "type": "string" }, "description": "Required. Array of ids to accommodate multiple discovery documents", "type": "array" } } }, "MarkAlertAsTriagedRequest": { "description": "Request message for MarkAlertAsTriaged.", "type": "object" }, "TechnologyWatchListAlertThreshold": { "type": "object", "description": "TechnologyWatchListAlertThreshold contains the thresholds for alerting.", "properties": { "riskRatingMinimum": { "description": "Optional. The minimum risk rating for the alert.", "enum": [ "RISK_RATING_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "CRITICAL", "UNRATED" ], "type": "string", "x-google-enum-descriptions": [ "Unspecified risk rating. This is the default value when the risk rating\nis not set.", "Low risk rating.", "Medium risk rating.", "High risk rating.", "Critical risk rating.", "The vulnerability has been assessed, but a specific risk rating could\nnot be determined or assigned." ] }, "exploitationStates": { "type": "array", "description": "Optional. The exploitation states of the alert.", "items": { "$ref": "#/components/schemas/ExploitationState" } }, "priorityMinimum": { "type": "string", "x-google-enum-descriptions": [ "Unspecified priority.", "Priority level 0.", "Priority level 1.", "Priority level 2.", "Priority level 3.", "Priority level 4." ], "description": "Optional. The minimum priority for the alert.", "enum": [ "PRIORITY_UNSPECIFIED", "P0", "P1", "P2", "P3", "P4" ] }, "cvssScoreMinimum": { "type": "number", "description": "Optional. The minimum CVSS score for the alert. Evaluates to CVSS v3 when available\nwith a fallback to v2 and v4. Ex: 7.0. Valid range is [0.0, 10.0].", "format": "float" }, "epssScoreMinimum": { "description": "Optional. The minimum epss score for the alert. Ex: 0.8. Valid range is [0.0, 1.0].", "type": "number", "format": "float" } } }, "InitialAccessBrokerFindingDetail": { "type": "object", "description": "A detail object for an Initial Access Broker (IAB) finding.", "properties": { "severity": { "type": "string", "description": "Required. The severity of the IAB finding. This indicates the potential\nimpact of the threat.", "x-google-enum-descriptions": [ "", "", "", "", "" ], "enum": [ "SEVERITY_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "CRITICAL" ] }, "matchScore": { "format": "float", "description": "Required. Reference to the match score of the IAB finding. This is a float value\nbetween 0 and 1 calculated by the matching engine based on the similarity\nof the document and the user provided configurations.", "type": "number" }, "documentId": { "description": "Required. The unique identifier of the document that triggered the IAB finding.\nThis ID can be used to retrieve the content of the document for further\nanalysis.", "type": "string" } }, "required": [ "matchScore", "severity", "documentId" ] }, "PriorityAnalysis": { "properties": { "confidence": { "allOf": [ { "$ref": "#/components/schemas/ConfidenceLevel" } ], "description": "The level of confidence in the given verdict." }, "reasoning": { "type": "string", "description": "Human-readable explanation from the model, detailing why a particular\nresult is considered to have a certain priority." }, "priorityLevel": { "allOf": [ { "$ref": "#/components/schemas/PriorityLevel" } ], "description": "The level of Priority." } }, "description": "Structured priority analysis for a threat.", "type": "object" }, "AlertDocument": { "properties": { "name": { "type": "string", "x-google-identifier": true, "description": "Identifier. Server generated name for the alert document.\nformat is projects/{project}/alerts/{alert}/documents/{document}" }, "title": { "type": "string", "readOnly": true, "description": "Output only. The title of the document, if available." }, "collectionTime": { "description": "Output only. Time when the origin source collected the intel.", "readOnly": true, "type": "string", "format": "date-time" }, "sourceUpdateTime": { "description": "Output only. Time when the intel was last updated by the source.", "format": "date-time", "type": "string", "readOnly": true }, "languageCode": { "readOnly": true, "type": "string", "description": "Output only. The language code of the document." }, "createTime": { "format": "date-time", "description": "Output only. The timestamp of the original external publication of the document.", "readOnly": true, "type": "string" }, "aiSummary": { "description": "Output only. AI summary of the document.", "type": "string", "readOnly": true }, "sourceUri": { "description": "Output only. URI of the intel item from the source.", "type": "string", "readOnly": true }, "content": { "readOnly": true, "description": "Output only. The content of the document.", "type": "string" }, "author": { "readOnly": true, "type": "string", "description": "Output only. The author of the document." }, "ingestTime": { "readOnly": true, "type": "string", "description": "Output only. Time when GTI received the intel.", "format": "date-time" }, "source": { "description": "Output only. Source of the intel item, e.g. DarkMarket.", "type": "string", "readOnly": true }, "translation": { "description": "Output only. The translation of the document, if available.", "readOnly": true, "allOf": [ { "$ref": "#/components/schemas/AlertDocumentTranslation" } ] } }, "type": "object", "description": "A document that is associated with an alert." }, "MarkAlertAsNotActionableRequest": { "description": "Request message for MarkAlertAsNotActionable.", "type": "object" }, "TechnologyWatchListConfig": { "type": "object", "description": "TechnologyWatchListConfig is the configuration for the technology watchlist.", "properties": { "technologies": { "type": "array", "description": "Optional. List of vendor, technology or cpe fingerprint.\nexample:\n Microsoft office 360\n Apache Server 3.5\n cpe:2.3:a:microsoft:outlook:*:*:*:*:*:*:*:*", "items": { "type": "string" } }, "alertThreshold": { "allOf": [ { "$ref": "#/components/schemas/TechnologyWatchListAlertThreshold" } ], "description": "Optional. Alert thresholds to effectively reduce noise." } } }, "AlertDocumentTranslation": { "type": "object", "description": "The translation of an alert document.", "properties": { "translatedTitle": { "readOnly": true, "description": "Output only. The translated title of the document.", "type": "string" }, "translatedContent": { "description": "Output only. The translated content of the document.", "type": "string", "readOnly": true } } }, "ListConfigurationRevisionsResponse": { "description": "Response message for ListConfigurationRevisions.", "type": "object", "properties": { "revisions": { "type": "array", "description": "The Configuration Revisions associated with the specified Configuration", "items": { "$ref": "#/components/schemas/ConfigurationRevision" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page.\nIf this field is omitted, there are no subsequent pages.", "type": "string" } } }, "ConfigurationRevision": { "description": "A ConfigurationRevision is a snapshot of a Configuration at a point in time.\nIt is immutable.", "type": "object", "properties": { "createTime": { "readOnly": true, "type": "string", "description": "Output only. The time the Revision was created", "format": "date-time" }, "name": { "type": "string", "description": "Identifier. The name of the ConfigurationRevision\nFormat: projects//configurations//revisions/", "x-google-identifier": true }, "snapshot": { "description": "The snapshot of the configuration", "allOf": [ { "$ref": "#/components/schemas/Configuration" } ] } } }, "TargetTechnologyAlertDetail": { "description": "Contains details for a technology watchlist alert.", "type": "object", "properties": { "vulnerabilityMatch": { "allOf": [ { "$ref": "#/components/schemas/VulnerabilityMatch" } ], "description": "Optional. The vulnerability match details." } } }, "LegacyMetadata": { "properties": { "displayName": { "description": "Output only. Name of the legacy monitor.", "readOnly": true, "type": "string" }, "creatorUserId": { "type": "string", "readOnly": true, "description": "Output only. User ID who created the monitor." }, "aggregationEnabled": { "readOnly": true, "description": "Output only. Whether aggregation is enabled for alerts from this monitor.", "type": "boolean" }, "legacyMonitorId": { "type": "string", "readOnly": true, "description": "Output only. Unique identifier of the legacy monitor." }, "tenantId": { "readOnly": true, "description": "Output only. ID of the tenant owning the monitor.", "type": "string" }, "staleTime": { "description": "Output only. Time the legacy monitor was considered stale.", "readOnly": true, "type": "string", "format": "date-time" }, "conditionVersion": { "readOnly": true, "description": "Output only. Version of the condition schema.", "format": "int32", "type": "integer" }, "description": { "description": "Output only. Description of the legacy monitor.", "type": "string", "readOnly": true }, "aggregationSimilarity": { "type": "number", "description": "Output only. Similarity threshold for aggregation.", "readOnly": true, "format": "double" }, "disabledCode": { "description": "Output only. Code indicating why the monitor is disabled (if applicable).", "type": "string", "readOnly": true }, "disabledReason": { "readOnly": true, "type": "string", "description": "Output only. Reason why the monitor is disabled (if applicable)." }, "emailNotificationImmediate": { "readOnly": true, "type": "boolean", "deprecated": true, "description": "Output only. Deprecated: Whether email notifications are intermediate/immediate. This\nfield will not be used as email notifications are handled through the\nGTI Mail Hub." }, "updaterUserId": { "readOnly": true, "description": "Output only. User ID who last updated the monitor.", "type": "string" }, "emailNotificationEnabled": { "deprecated": true, "type": "boolean", "readOnly": true, "description": "Output only. Deprecated: Whether email notifications are enabled. This field will not\nbe used as email notifications are handled through the GTI Mail Hub." }, "templateId": { "description": "Output only. ID of the template this monitor was created from.", "readOnly": true, "type": "string" }, "version": { "format": "int32", "type": "integer", "description": "Output only. Version of the monitor configuration.", "readOnly": true } }, "type": "object", "description": "Legacy metadata associated with this scenario/monitor." }, "CustomerProfileCitation": { "type": "object", "properties": { "retrievalTime": { "description": "The time the citation was retrieved.", "type": "string", "format": "date-time" }, "document": { "type": "string", "description": "Required. The name of the document the citation is from." }, "citationId": { "description": "Required. The citation id for the citation. Should be unique within the profile.", "type": "string" }, "uri": { "type": "string", "description": "Optional. The url of the citation." }, "source": { "type": "string", "description": "Required. The source of the citation." } }, "description": "Citation information for the customer profile.", "required": [ "citationId", "source", "document" ] }, "CustomerProfileIndustry": { "type": "object", "required": [ "industry" ], "description": "Industry information for the customer profile.", "properties": { "industry": { "type": "string", "description": "Required. The name of the industry." }, "citationIds": { "items": { "type": "string" }, "description": "Optional. The citation ids for the industry.", "type": "array" } } }, "GetPasswordResponse": { "type": "object", "description": "Response message for GetPassword.", "properties": { "password": { "description": "The decrypted cleartext password for the compromised credential.", "type": "string" } } }, "FindingDetail": { "properties": { "detailType": { "readOnly": true, "type": "string", "description": "Output only. Name of the detail type. Will be set by the server during creation to the\nname of the field that is set in the detail union." }, "initialAccessBroker": { "allOf": [ { "$ref": "#/components/schemas/InitialAccessBrokerFindingDetail" } ], "description": "Initial Access Broker finding detail type." }, "insiderThreat": { "description": "Insider Threat finding detail type.", "allOf": [ { "$ref": "#/components/schemas/InsiderThreatFindingDetail" } ] }, "targetTechnology": { "description": "Technology Watchlist finding detail type.", "allOf": [ { "$ref": "#/components/schemas/TargetTechnologyFindingDetail" } ] }, "dataLeak": { "allOf": [ { "$ref": "#/components/schemas/DataLeakFindingDetail" } ], "description": "Data Leak finding detail type." } }, "description": "Wrapper class that contains the union struct for all the various findings\ndetail specific classes.", "type": "object" }, "SeverityAnalysis": { "properties": { "reasoning": { "type": "string", "description": "Human-readable explanation from the model, detailing why a particular\nresult is considered to have a certain severity." }, "confidence": { "allOf": [ { "$ref": "#/components/schemas/ConfidenceLevel" } ], "description": "The level of confidence in the given verdict." }, "severityLevel": { "description": "The level of severity.", "allOf": [ { "$ref": "#/components/schemas/SeverityLevel" } ] } }, "description": "Structured severity analysis for a threat.", "type": "object" }, "RelevanceLevel": { "enum": [ "RELEVANCE_LEVEL_UNSPECIFIED", "RELEVANCE_LEVEL_LOW", "RELEVANCE_LEVEL_MEDIUM", "RELEVANCE_LEVEL_HIGH" ], "x-google-enum-descriptions": [ "Default value, should never be set.", "Low Relevance.", "Medium Relevance.", "High Relevance." ], "type": "string" }, "EnumerateAlertFacetsResponse": { "description": "Response message for EnumerateAlertFacets.", "type": "object", "properties": { "facets": { "items": { "$ref": "#/components/schemas/Facet" }, "description": "List of facets and the counts.", "type": "array" } } }, "UpsertConfigurationResponse": { "description": "Response message for UpsertConfiguration.", "properties": { "configuration": { "type": "string", "description": "Output only. Created configuration ID with server assigned id.", "readOnly": true } }, "type": "object" }, "DomainMonitoringFeatureConfig": { "type": "object", "properties": { "disabled": { "description": "Optional. Whether the Domain Monitoring feature is disabled for the domain.", "type": "boolean" } }, "description": "Specific configuration for the Domain Monitoring feature." }, "MarkAlertAsResolvedRequest": { "type": "object", "description": "Request message for MarkAlertAsResolved." }, "FacetCount": { "properties": { "value": { "type": "string", "description": "Value of the facet stringified.\nTimestamps will be formatted using RFC3339." }, "count": { "type": "integer", "description": "Count of records with the value.", "format": "int32" } }, "description": "FacetCount represents a count of records with each facet value.", "type": "object" }, "Association": { "type": "object", "required": [ "id", "type" ], "properties": { "id": { "description": "Required. The ID of the association.", "type": "string" }, "type": { "description": "Required. The type of the association.", "allOf": [ { "$ref": "#/components/schemas/ThreatIntelObjectType" } ] } }, "description": "Represents an association with a vulnerability." }, "Configuration": { "type": "object", "description": "A configuration represents a behavior an engine should follow when producing\nnew findings.", "required": [ "provider", "detail" ], "properties": { "etag": { "description": "If included when updating a configuration, this should be set to the\ncurrent etag of the configuration. If the etags do not match, the update\nwill be rejected and an ABORTED error will be returned.", "type": "string" }, "name": { "x-google-identifier": true, "type": "string", "description": "Identifier. Server generated name for the configuration.\nformat is projects/{project}/configurations/{configuration}" }, "displayName": { "type": "string", "readOnly": true, "description": "Output only. Human readable name for the configuration." }, "audit": { "allOf": [ { "$ref": "#/components/schemas/Audit" } ], "readOnly": true, "description": "Output only. Audit information for the configuration." }, "detail": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationDetail" } ], "description": "Required. Domain specific details for the configuration." }, "version": { "description": "Optional. A user-manipulatable version. Does not adhere to a specific format", "type": "string" }, "description": { "description": "Optional. A description of the configuration.", "type": "string" }, "state": { "type": "string", "description": "Optional. State of the configuration.", "x-google-enum-descriptions": [ "Configuration state is unspecified. This is not expected to occur.", "Configuration is enabled for the customer.", "Configuration is disabled for the customer.", "Configuration is deprecated, no new configs are allowed to be created." ], "enum": [ "STATE_UNSPECIFIED", "ENABLED", "DISABLED", "DEPRECATED" ] }, "provider": { "description": "Required. Name of the service that provides the configuration.", "type": "string" } } }, "CustomerProfileConfig": { "type": "object", "properties": { "products": { "type": "array", "description": "Optional. Product information for the organization.", "items": { "$ref": "#/components/schemas/CustomerProfileProduct" } }, "contactInfo": { "description": "Optional. Contact information for the organization.", "type": "array", "items": { "$ref": "#/components/schemas/CustomerProfileContactInfo" } }, "summary": { "description": "Optional. A summarized version of the customer profile.", "allOf": [ { "$ref": "#/components/schemas/CustomerProfileSummary" } ] }, "org": { "type": "string", "description": "Required. The name of the organization." }, "technologyPresence": { "description": "Optional. Technology presence of the organization.", "type": "string" }, "locations": { "description": "Optional. Locations the organization is present or conducts business in.", "items": { "$ref": "#/components/schemas/CustomerProfileLocation" }, "type": "array" }, "orgSummary": { "description": "Optional. A summary of the organization.", "type": "string" }, "industries": { "items": { "$ref": "#/components/schemas/CustomerProfileIndustry" }, "type": "array", "description": "Optional. The industries the organization is involved in." }, "parentCompanies": { "items": { "$ref": "#/components/schemas/CustomerProfileCompany" }, "description": "Optional. The parent companies of the organization.", "type": "array" }, "executives": { "items": { "$ref": "#/components/schemas/CustomerProfilePerson" }, "type": "array", "description": "Optional. Executives of the organization." }, "webPresences": { "type": "array", "items": { "$ref": "#/components/schemas/CustomerProfileWebPresence" }, "description": "Optional. Web presence of the organization." }, "citations": { "type": "array", "description": "Optional. Citations for the organization profile.", "items": { "$ref": "#/components/schemas/CustomerProfileCitation" } }, "securityConsiderations": { "allOf": [ { "$ref": "#/components/schemas/CustomerProfileSecurityConsiderations" } ], "description": "Optional. Security considerations for the organization." } }, "required": [ "org" ], "description": "CustomerProfileConfig is the configuration for the customer profile." }, "CustomerProfileContactInfo": { "type": "object", "properties": { "email": { "type": "string", "description": "The email address of the contact." }, "citationIds": { "items": { "type": "string" }, "description": "Optional. The citation ids for the contact information.", "type": "array" }, "other": { "type": "string", "description": "The other contact information." }, "address": { "description": "The address of the contact.", "type": "string" }, "phone": { "description": "The phone number of the contact.", "type": "string" }, "label": { "description": "Optional. The name of the contact.", "type": "string" } }, "description": "Contact information for the customer profile." }, "DomainSetting": { "type": "object", "required": [ "domain" ], "properties": { "domainMonitoringConfig": { "allOf": [ { "$ref": "#/components/schemas/DomainMonitoringFeatureConfig" } ], "description": "Optional. If not present, Domain Monitoring is enabled." }, "domain": { "type": "string", "description": "Required. The domain name to match against." }, "state": { "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "PENDING", "VERIFIED" ], "x-google-enum-descriptions": [ "Default value. This value is unused.", "Verification is pending. The customer needs to add the TXT record.", "Verification succeeded." ], "description": "Output only. The verification state of the domain.", "type": "string" } }, "description": "Feature settings and toggles for a single specific domain." }, "Audit": { "description": "Tracks basic CRUD facts.", "type": "object", "properties": { "updateTime": { "readOnly": true, "format": "date-time", "description": "Output only. Time of creation or last update.", "type": "string" }, "createTime": { "description": "Output only. Time of creation.", "type": "string", "readOnly": true, "format": "date-time" }, "creator": { "readOnly": true, "type": "string", "description": "Output only. Agent that created or updated the record, could be a UserId or a JobId." }, "updater": { "description": "Output only. Agent that last updated the record, could be a UserId or a JobId.", "type": "string", "readOnly": true } } }, "ThreatIntelObjectType": { "type": "string", "enum": [ "THREAT_INTEL_OBJECT_TYPE_UNSPECIFIED", "THREAT_INTEL_OBJECT_TYPE_THREAT_ACTOR", "THREAT_INTEL_OBJECT_TYPE_MALWARE", "THREAT_INTEL_OBJECT_TYPE_REPORT", "THREAT_INTEL_OBJECT_TYPE_CAMPAIGN", "THREAT_INTEL_OBJECT_TYPE_IOC_COLLECTION", "THREAT_INTEL_OBJECT_TYPE_SOFTWARE_AND_TOOLKITS", "THREAT_INTEL_OBJECT_TYPE_VULNERABILITY" ], "x-google-enum-descriptions": [ "Unspecified object type.", "Threat actor object type.", "Malware object type.", "Report object type.", "Campaign object type.", "IoC Collection object type.", "Software and toolkits object type.", "Vulnerability object type." ] }, "ListFindingsResponse": { "description": "Response message for ListFindings.", "type": "object", "properties": { "findings": { "type": "array", "description": "List of findings.", "items": { "$ref": "#/components/schemas/Finding" } }, "nextPageToken": { "type": "string", "description": "Page token." } } }, "MarkAlertAsDuplicateRequest": { "description": "Request message for MarkAlertAsDuplicate.", "properties": { "duplicateOf": { "description": "Optional. Name of the alert to mark as a duplicate of.\nFormat: projects/{project}/alerts/{alert}", "type": "string" } }, "type": "object" }, "DocumentQuery": { "type": "object", "properties": { "query": { "description": "Required. The query string.", "type": "string" }, "queryType": { "description": "Required. The type of query.", "enum": [ "QUERY_TYPE_UNSPECIFIED", "QUERY_TYPE_LUCENE" ], "x-google-enum-descriptions": [ "Default value, should never be set.", "Lucene query type." ], "type": "string" }, "dataModel": { "type": "string", "x-google-enum-descriptions": [ "Default value, should never be set.", "GTI data model." ], "description": "Required. The data model to query against.", "enum": [ "DATA_MODEL_UNSPECIFIED", "DATA_MODEL_GTI" ] } }, "description": "Represents a query to match documents.", "required": [ "query", "queryType", "dataModel" ] }, "GenerateOrgProfileConfigurationRequest": { "type": "object", "description": "Request message for GenerateOrgProfileConfiguration.", "required": [ "domain", "displayName" ], "properties": { "displayName": { "description": "Required. The display name of the organization to generate the profile for.", "type": "string" }, "domain": { "type": "string", "description": "Required. The domain of the organization to generate the profile for." } } }, "OperationMetadata": { "properties": { "createTime": { "type": "string", "format": "date-time", "description": "The time the operation was created." }, "updateTime": { "description": "The time the operation was last updated.", "type": "string", "format": "date-time" } }, "type": "object", "description": "Metadata for the long-running operation." }, "Facet": { "type": "object", "description": "Facet represents a sub element of a resource for filtering.\nThe results from this method are used to populate the filterable facets in\nthe UI.", "properties": { "totalCount": { "type": "string", "description": "Total number of records that contain this facet with ANY value.", "format": "int64" }, "facet": { "type": "string", "description": "Name of the facet. This is also the string that needs to be used in the\nfiltering expression." }, "minValue": { "description": "Min value of the facet stringified based on type. This is only populated\nfor facets that have a clear ordering, for types like enum it will be\nleft empty.\nTimestamps will be formatted using RFC3339.", "type": "string" }, "facetCounts": { "items": { "$ref": "#/components/schemas/FacetCount" }, "description": "List of counts for the facet (if categorical).", "type": "array" }, "maxValue": { "description": "Max value of the facet stringified based on type. Will be populated and\nformatted the same as min_value.", "type": "string" }, "facetType": { "description": "The type of the facet. Options include \"string\", \"int\", \"float\", \"bool\",\n\"enum\", \"timestamp\", \"user\" and are useful to show the right sort of\nUI controls when building a AIP-160 style filtering string.", "type": "string" } } }, "ConfidenceLevel": { "enum": [ "CONFIDENCE_LEVEL_UNSPECIFIED", "CONFIDENCE_LEVEL_LOW", "CONFIDENCE_LEVEL_MEDIUM", "CONFIDENCE_LEVEL_HIGH" ], "x-google-enum-descriptions": [ "Default value. Confidence level is not specified.", "Low confidence in the verdict.", "Medium confidence in the verdict.", "High confidence in the verdict." ], "type": "string" }, "CustomThreatScenarioConfig": { "type": "object", "description": "CustomThreatScenarioConfig represents a user-defined threat scenario\nconfiguration.", "properties": { "documentCondition": { "description": "Required. The condition driving the scenario, stored as a stringified JSON.\nThis is used to query/filter documents.", "type": "string" }, "legacyMonitorMetadata": { "readOnly": true, "description": "Output only. Legacy metadata associated with this scenario/monitor.", "allOf": [ { "$ref": "#/components/schemas/LegacyMetadata" } ] }, "documentQuery": { "description": "Optional. The query used to match documents.", "allOf": [ { "$ref": "#/components/schemas/DocumentQuery" } ] }, "compiledLuceneQuery": { "description": "Output only. The compiled Lucene query string.", "type": "string", "readOnly": true } }, "required": [ "documentCondition" ] }, "CustomerProfileProduct": { "required": [ "product", "brand" ], "properties": { "citationIds": { "items": { "type": "string" }, "description": "Optional. The citation ids for the product.", "type": "array" }, "product": { "type": "string", "description": "Required. The name of the product." }, "brand": { "description": "Required. The brand of the product.", "type": "string" } }, "description": "Product information for the customer profile.", "type": "object" }, "RelevanceAnalysis": { "type": "object", "description": "Structured relevance analysis for a threat.", "properties": { "reasoning": { "type": "string", "description": "Human-readable explanation from the matcher, detailing why a particular\nresult is considered relevant or not relevant." }, "confidence": { "description": "The level of confidence in the given verdict.", "allOf": [ { "$ref": "#/components/schemas/ConfidenceLevel" } ] }, "evidence": { "description": "Evidence supporting the verdict, including matched and unmatched items.", "allOf": [ { "$ref": "#/components/schemas/Evidence" } ] }, "relevanceLevel": { "allOf": [ { "$ref": "#/components/schemas/RelevanceLevel" } ], "description": "The level of relevance." }, "relevant": { "type": "boolean", "description": "Indicates whether the threat is considered relevant." } } }, "CustomerProfileSummary": { "properties": { "primaryWebsite": { "description": "Optional. The primary website of the customer.", "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ] }, "founded": { "description": "Optional. The date the customer was founded.", "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ] }, "areaServed": { "description": "Optional. The area the customer serves.", "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ] }, "parentCompany": { "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ], "description": "Optional. The parent company of the customer." }, "keyPeopleSummary": { "description": "Optional. A narrative summary of key people.", "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ] }, "productsSummary": { "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ], "description": "Optional. A narrative summary of products." }, "headquarters": { "description": "Optional. The headquarters of the customer.", "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ] }, "entityType": { "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ], "description": "Optional. The entity type of the customer." }, "industry": { "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ], "description": "Optional. The industry the customer is in." }, "brands": { "description": "Optional. A narrative summary of brands.", "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ] }, "servicesSummary": { "description": "Optional. A narrative summary of services.", "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ] }, "title": { "description": "Optional. The official name of the customer.", "allOf": [ { "$ref": "#/components/schemas/CustomerProfileCitedString" } ] } }, "description": "A summarized version of the customer profile.\nGenerated by the backend.", "type": "object" }, "CustomerProfileLocation": { "properties": { "facilityType": { "description": "Optional. The type of location.", "type": "string" }, "address": { "description": "Required. The address of the location.", "type": "string" }, "citationIds": { "description": "Optional. The citation ids for the location.", "type": "array", "items": { "type": "string" } }, "brand": { "type": "string", "description": "Required. The brand of the location." } }, "description": "Location information for the customer profile.", "required": [ "brand", "address" ], "type": "object" }, "ListConfigurationsResponse": { "type": "object", "properties": { "configurations": { "items": { "$ref": "#/components/schemas/Configuration" }, "type": "array", "description": "List of configurations." }, "nextPageToken": { "type": "string", "description": "Page token." } }, "description": "Response message for ListConfigurations." }, "Alert": { "description": "Stateful object representing a group of Findings. Key feature to an Alert\nis that it expresses the user's intent towards the findings of that group,\neven those that haven't occurred yet.", "type": "object", "properties": { "configurations": { "description": "Output only. The resource names of the Configurations bound to this alert.\nFormat: projects/{project}/configurations/{configuration}", "readOnly": true, "items": { "type": "string" }, "type": "array" }, "findingCount": { "readOnly": true, "type": "string", "description": "Output only. The number of findings associated with this alert.", "format": "int64" }, "state": { "type": "string", "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "NEW", "READ", "TRIAGED", "ESCALATED", "RESOLVED", "DUPLICATE", "FALSE_POSITIVE", "NOT_ACTIONABLE", "BENIGN", "TRACKED_EXTERNALLY" ], "x-google-enum-descriptions": [ "Default value, should never be set.", "alert is new.", "alert was read by a human.", "alert has been triaged.", "alert has been escalated.", "alert has been resolved.", "alert is a duplicate of another alert.", "alert is a false positive and should be ignored.", "alert is not actionable.", "alert is benign.", "alert is tracked externally." ], "description": "Output only. State of the alert." }, "displayName": { "readOnly": true, "type": "string", "description": "Output only. A short title for the alert." }, "duplicatedBy": { "type": "array", "items": { "type": "string" }, "readOnly": true, "description": "Output only. alert names of the alerts that are duplicates of this alert.\nFormat: projects/{project}/alerts/{alert}" }, "findings": { "type": "array", "items": { "type": "string" }, "readOnly": true, "description": "Output only. Findings that are covered by this alert." }, "aiSummary": { "description": "Optional. AI summary of the alert.", "type": "string" }, "etag": { "type": "string", "description": "Optional. If included when updating an alert, this should be set to the current etag\nof the alert. If the etags do not match, the update will be rejected and\nan ABORTED error will be returned." }, "audit": { "allOf": [ { "$ref": "#/components/schemas/Audit" } ], "description": "Output only. Audit information for the alert.", "readOnly": true }, "severityAnalysis": { "readOnly": true, "allOf": [ { "$ref": "#/components/schemas/SeverityAnalysis" } ], "description": "Output only. High-Precision Severity Analysis for the alert." }, "externalId": { "type": "string", "description": "Output only. External ID for the alert. This is used internally to provide protection\nagainst out of order updates.", "readOnly": true }, "relevanceAnalysis": { "allOf": [ { "$ref": "#/components/schemas/RelevanceAnalysis" } ], "readOnly": true, "description": "Output only. High-Precision Relevance Analysis verdict for the alert." }, "name": { "description": "Identifier. Server generated name for the alert.\nformat is projects/{project}/alerts/{alert}", "x-google-identifier": true, "type": "string" }, "detail": { "readOnly": true, "description": "Output only. Details object for the alert, not all alerts will have a details object.", "allOf": [ { "$ref": "#/components/schemas/AlertDetail" } ] }, "priorityAnalysis": { "readOnly": true, "allOf": [ { "$ref": "#/components/schemas/PriorityAnalysis" } ], "description": "Output only. High-Precision Priority Analysis for the alert." }, "duplicateOf": { "description": "Output only. alert name of the alert this alert is a duplicate of.\nFormat: projects/{project}/alerts/{alert}", "readOnly": true, "type": "string" } } }, "CustomerProfileCompany": { "required": [ "company" ], "type": "object", "description": "Company information for the customer profile.", "properties": { "company": { "description": "Required. The name of the company.", "type": "string" }, "citationIds": { "description": "Optional. The citation ids for the company.", "type": "array", "items": { "type": "string" } } } } } } }