--- title: "POST /v1beta/{+parent}/configurations:upsert" method: POST path: "/v1beta/{+parent}/configurations:upsert" tags: ["projects"] --- # POST /v1beta/{+parent}/configurations:upsert `POST /v1beta/{+parent}/configurations:upsert` Creates or updates a configuration. ## Path parameters - `parent` string, required ## Query parameters - `publishTime` string ## Request body - Configuration — A configuration represents a behavior an engine should follow when producing new findings. - `audit` Audit — Tracks basic CRUD facts. - `updateTime` string, google-datetime — Output only. Time of creation or last update. - `createTime` string, google-datetime — Output only. Time of creation. - `creator` string — Output only. Agent that created or updated the record, could be a UserId or a JobId. - `updater` string — Output only. Agent that last updated the record, could be a UserId or a JobId. - `provider` string — Required. Name of the service that provides the configuration. - `displayName` string — Output only. Human readable name for the configuration. - `detail` ConfigurationDetail — Wrapper class that contains the union struct for all the various configuration detail specific classes. - `customerProfile` CustomerProfileConfig — CustomerProfileConfig is the configuration for the customer profile. - `org` string — Required. The name of the organization. - `orgSummary` string — Optional. A summary of the organization. - `products` CustomerProfileProduct[] — Optional. Product information for the organization. - `citationIds` string[] — Optional. The citation ids for the product. - `product` string — Required. The name of the product. - `brand` string — Required. The brand of the product. - `citations` CustomerProfileCitation[] — Optional. Citations for the organization profile. - `retrievalTime` string, google-datetime — The time the citation was retrieved. - `source` string — Required. The source of the citation. - `citationId` string — Required. The citation id for the citation. Should be unique within the profile. - `document` string — Required. The name of the document the citation is from. - `uri` string — Optional. The url of the citation. - `executives` CustomerProfilePerson[] — Optional. Executives of the organization. - `name` string — Required. The name of the person. - `title` string — Optional. The title of the person. - `citationIds` string[] — Optional. The citation ids for the person. - `parentCompanies` CustomerProfileCompany[] — Optional. The parent companies of the organization. - `company` string — Required. The name of the company. - `citationIds` string[] — Optional. The citation ids for the company. - `webPresences` CustomerProfileWebPresence[] — Optional. Web presence of the organization. - `domain` string — Required. The domain name of the web presence. - `citationIds` string[] — Optional. The citation ids for the web presence. - `technologyPresence` string — Optional. Technology presence of the organization. - `locations` CustomerProfileLocation[] — Optional. Locations the organization is present or conducts business in. - `citationIds` string[] — Optional. The citation ids for the location. - `address` string — Required. The address of the location. - `facilityType` string — Optional. The type of location. - `brand` string — Required. The brand of the location. - `contactInfo` CustomerProfileContactInfo[] — Optional. Contact information for the organization. - `citationIds` string[] — Optional. The citation ids for the contact information. - `other` string — The other contact information. - `address` string — The address of the contact. - `email` string — The email address of the contact. - `phone` string — The phone number of the contact. - `label` string — Optional. The name of the contact. - `summary` CustomerProfileSummary — A summarized version of the customer profile. Generated by the backend. - `areaServed` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `keyPeopleSummary` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `productsSummary` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `founded` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `brands` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `entityType` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `servicesSummary` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `primaryWebsite` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `industry` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `title` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `headquarters` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `parentCompany` CustomerProfileCitedString — A string with citation ids. - `value` string — Required. The value of the string. - `citationIds` string[] — Optional. The citation ids for the string. - `securityConsiderations` CustomerProfileSecurityConsiderations — Security considerations for the customer profile. - `note` string — Optional. A note about the security considerations. - `considerations` string[] — Optional. A series of considerations for the security of the organization, such as "high risk of compromise" or "vulnerable to cyberbullying". - `industries` CustomerProfileIndustry[] — Optional. The industries the organization is involved in. - `industry` string — Required. The name of the industry. - `citationIds` string[] — Optional. The citation ids for the industry. - `detailType` string — Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union. - `technologyWatchlist` TechnologyWatchListConfig — TechnologyWatchListConfig is the configuration for the technology watchlist. - `technologies` string[] — Optional. List of vendor, technology or cpe fingerprint. example: Microsoft office 360 Apache Server 3.5 cpe:2.3:a:microsoft:outlook:*:*:*:*:*:*:*:* - `alertThreshold` TechnologyWatchListAlertThreshold — TechnologyWatchListAlertThreshold contains the thresholds for alerting. - `exploitationStates` string[] — Optional. The exploitation states of the alert. - `cvssScoreMinimum` number, float — Optional. The minimum CVSS score for the alert. Evaluates to CVSS v3 when available with a fallback to v2 and v4. Ex: 7.0. Valid range is [0.0, 10.0]. - `riskRatingMinimum` 'RISK_RATING_UNSPECIFIED' | 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL' | 'UNRATED' — Optional. The minimum risk rating for the alert. - `priorityMinimum` 'PRIORITY_UNSPECIFIED' | 'P0' | 'P1' | 'P2' | 'P3' | 'P4' — Optional. The minimum priority for the alert. - `epssScoreMinimum` number, float — Optional. The minimum epss score for the alert. Ex: 0.8. Valid range is [0.0, 1.0]. - `description` string — Optional. A description of the configuration. - `version` string — Optional. A user-manipulatable version. Does not adhere to a specific format - `etag` string — If included when updating a configuration, this should be set to the current etag of the configuration. If the etags do not match, the update will be rejected and an ABORTED error will be returned. - `state` 'STATE_UNSPECIFIED' | 'ENABLED' | 'DISABLED' | 'DEPRECATED' — Optional. State of the configuration. - `name` string — Identifier. Server generated name for the configuration. format is projects/{project}/configurations/{configuration} ## Response `200` Successful response --- [API](https://skmtc.dev/google/apis/threatintelligence.md) · [All operations](https://skmtc.dev/google/apis/threatintelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/threatintelligence/revisions/c1698c3ee8d5/schema)