---
title: "POST /v1/{+parent}/insightsConfigs"
method: POST
path: "/v1/{+parent}/insightsConfigs"
tags: ["projects"]
---

# POST /v1/{+parent}/insightsConfigs

`POST /v1/{+parent}/insightsConfigs`

Creates a new InsightsConfig in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `insightsConfigId` string
- `validateOnly` boolean

## Request body

- InsightsConfig — The InsightsConfig resource is the core configuration object to capture events from your Software Development Lifecycle. It acts as the central hub for managing how Developer Connect understands your application, its runtime environments, and the artifacts deployed within them.
  - `appHubApplication` string — Optional. The name of the App Hub Application. Format: projects/{project}/locations/{location}/applications/{application}
  - `createTime` string, google-datetime — Output only. Create timestamp.
  - `reconciling` boolean — Output only. Reconciling (https://google.aip.dev/128#reconciliation). Set to true if the current state of InsightsConfig does not match the user's intended state, and the service is actively updating the resource to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.
  - `name` string — Identifier. The name of the InsightsConfig. Format: projects/{project}/locations/{location}/insightsConfigs/{insightsConfig}
  - `runtimeConfigs` RuntimeConfig[] — Output only. The runtime configurations where the application is deployed.
    - `googleCloudRun` GoogleCloudRun — GoogleCloudRun represents the Cloud Run runtime.
      - `serviceUri` string — Required. Immutable. The name of the Cloud Run service. Format: `projects/{project}/locations/{location}/services/{service}`.
    - `appHubService` AppHubService — AppHubService represents the App Hub Service.
      - `apphubService` string — Required. Output only. Immutable. The name of the App Hub Service. Format: `projects/{project}/locations/{location}/applications/{application}/services/{service}`.
      - `criticality` string — Output only. The criticality of the App Hub Service.
      - `environment` string — Output only. The environment of the App Hub Service.
    - `state` 'STATE_UNSPECIFIED' | 'LINKED' | 'UNLINKED' — Output only. The state of the Runtime.
    - `gkeWorkload` GKEWorkload — GKEWorkload represents the Google Kubernetes Engine runtime.
      - `cluster` string — Required. Immutable. The name of the GKE cluster. Format: `projects/{project}/locations/{location}/clusters/{cluster}`.
      - `deployment` string — Output only. The name of the GKE deployment. Format: `projects/{project}/locations/{location}/clusters/{cluster}/namespaces/{namespace}/deployments/{deployment}`.
    - `uri` string — Required. Immutable. The URI of the runtime configuration. For GKE, this is the cluster name. For Cloud Run, this is the service name.
    - `appHubWorkload` AppHubWorkload — AppHubWorkload represents the App Hub Workload.
      - `workload` string — Required. Output only. Immutable. The name of the App Hub Workload. Format: `projects/{project}/locations/{location}/applications/{application}/workloads/{workload}`.
      - `criticality` string — Output only. The criticality of the App Hub Workload.
      - `environment` string — Output only. The environment of the App Hub Workload.
  - `annotations` object — Optional. User specified annotations. See https://google.aip.dev/148#annotations for more details such as format and size limitations.
  - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'COMPLETE' | 'ERROR' — Optional. Output only. The state of the InsightsConfig.
  - `errors` Status[] — Output only. Any errors that occurred while setting up the InsightsConfig. Each error will be in the format: `field_name: error_message`, e.g. GetAppHubApplication: Permission denied while getting App Hub application. Please grant permissions to the P4SA.
    - `details` object[] — A list of messages that carry the error details. There is a common set of message types for APIs to use.
    - `code` integer — The status code, which should be an enum value of google.rpc.Code.
    - `message` string — A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
  - `labels` object — Optional. Set of labels associated with an InsightsConfig.
  - `projects` Projects — Projects represents the projects to track with the InsightsConfig.
    - `projectIds` string[] — Optional. The project IDs. Format: {project}
  - `artifactConfigs` ArtifactConfig[] — Optional. The artifact configurations of the artifacts that are deployed.
    - `googleArtifactRegistry` GoogleArtifactRegistry — Google Artifact Registry configurations.
      - `artifactRegistryPackage` string — Required. Immutable. The name of the artifact registry package.
      - `projectId` string — Required. The host project of Artifact Registry.
    - `uri` string — Required. Immutable. The URI of the artifact that is deployed. e.g. `us-docker.pkg.dev/my-project/my-repo/image`. The URI does not include the tag / digest because it captures a lineage of artifacts.
    - `googleArtifactAnalysis` GoogleArtifactAnalysis — Google Artifact Analysis configurations.
      - `projectId` string — Required. The project id of the project where the provenance is stored.
  - `updateTime` string, google-datetime — Output only. Update timestamp.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/developerconnect.md) · [All operations](https://skmtc.dev/google/apis/developerconnect/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/developerconnect/revisions/2526b3369dcc/schema)