---
title: "POST /v1beta/projects/{project}/configurations:upsert"
method: POST
path: "/v1beta/projects/{project}/configurations:upsert"
tags: ["threatintelligence"]
---

# POST /v1beta/projects/{project}/configurations:upsert

`POST /v1beta/projects/{project}/configurations:upsert`

Creates or updates a configuration.

## Path parameters

- `project` string, required

## Query parameters

- `publishTime` string, date-time

## Headers

- `x-goog-user-project` string, required

## Request body

- Configuration — A configuration represents a behavior an engine should follow when producing new findings.
  - `name` string — Identifier. Server generated name for the configuration. format is projects/{project}/configurations/{configuration}
  - `displayName` string — Output only. Human readable name for the configuration.
  - `audit` Audit — Tracks basic CRUD facts.
    - `updateTime` string, date-time — Output only. Time of creation or last update.
    - `createTime` string, date-time — 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 — Required. Name of the service that provides the configuration.
  - `state` 'STATE_UNSPECIFIED' | 'ENABLED' | 'DISABLED' | 'DEPRECATED' — Optional. State of the configuration.
  - `detail` ConfigurationDetail, required — 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 — Required. The name of the organization.
      - `orgSummary` string — Optional. A summary of the organization.
      - `industries` CustomerProfileIndustry[] — Optional. The industries the organization is involved in.
        - `industry` string, required — Required. The name of the industry.
        - `citationIds` string[] — Optional. The citation ids for the industry.
      - `parentCompanies` CustomerProfileCompany[] — Optional. The parent companies of the organization.
        - `company` string, required — Required. The name of the company.
        - `citationIds` string[] — Optional. The citation ids for the company.
      - `products` CustomerProfileProduct[] — Optional. Product information for the organization.
        - `product` string, required — Required. The name of the product.
        - `brand` string, required — Required. The brand of the product.
        - `citationIds` string[] — Optional. The citation ids for the product.
      - `locations` CustomerProfileLocation[] — Optional. Locations the organization is present or conducts business in.
        - `facilityType` string — Optional. The type of location.
        - `brand` string, required — Required. The brand of the location.
        - `address` string, required — Required. The address of the location.
        - `citationIds` string[] — Optional. The citation ids for the location.
      - `executives` CustomerProfilePerson[] — Optional. Executives of the organization.
        - `name` string, required — Required. The name of the person.
        - `title` string — Optional. The title of the person.
        - `citationIds` string[] — Optional. The citation ids for the person.
      - `webPresences` CustomerProfileWebPresence[] — Optional. Web presence of the organization.
        - `domain` string, required — 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.
      - `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".
      - `contactInfo` CustomerProfileContactInfo[] — Optional. Contact information for the organization.
        - `email` string — The email address of the contact.
        - `phone` string — The phone number of the contact.
        - `address` string — The address of the contact.
        - `other` string — The other contact information.
        - `label` string — Optional. The name of the contact.
        - `citationIds` string[] — Optional. The citation ids for the contact information.
      - `citations` CustomerProfileCitation[] — Optional. Citations for the organization profile.
        - `citationId` string, required — Required. The citation id for the citation. Should be unique within the profile.
        - `uri` string — Optional. The url of the citation.
        - `retrievalTime` string, date-time — The time the citation was retrieved.
        - `source` string, required — Required. The source of the citation.
        - `document` string, required — Required. The name of the document the citation is from.
      - `summary` CustomerProfileSummary — A summarized version of the customer profile. Generated by the backend.
        - `title` CustomerProfileCitedString — A string with citation ids.
          - `value` string, required — 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 — 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 — 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 — 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 — Required. The value of the string.
          - `citationIds` string[] — Optional. The citation ids for the string.
        - `areaServed` CustomerProfileCitedString — A string with citation ids.
          - `value` string, required — 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 — 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 — 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 — 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 — 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 — 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 — Required. The value of the string.
          - `citationIds` string[] — Optional. The citation ids for the string.
    - `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.
  - `version` string — Optional. A user-manipulatable version. Does not adhere to a specific format
  - `description` string — Optional. A description of the configuration.

## Response `default`

Successful operation

- UpsertConfigurationResponse — Response message for UpsertConfiguration.
  - `configuration` string — Output only. Created configuration ID with server assigned id.

---

[API](https://skmtc.net/virustotal/apis/threat-landscape.md) · [All operations](https://skmtc.net/virustotal/apis/threat-landscape/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/virustotal/threat-landscape/versions/d61b85e6a6b3/schema)