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

# POST /v1/{+parent}/semanticGovernancePolicies

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

Creates a SemanticGovernancePolicy.

## Path parameters

- `parent` string, required

## Query parameters

- `semanticGovernancePolicyId` string

## Request body

- GoogleCloudAiplatformV1SemanticGovernancePolicy — Represents a governance policy applied to a specific Agent and optionally a specific Tool within that Agent.
  - `agent` string — Required. The name of the agent in Agent Registry that is affected by this policy.
  - `name` string — Identifier. Resource name of the SemanticGovernancePolicy.
  - `description` string — Optional. The description of the SemanticGovernancePolicy.
  - `displayName` string — Optional. The user-defined name of the SemanticGovernancePolicy.
  - `createTime` string, google-datetime — Output only. Timestamp when this SemanticGovernancePolicy was created.
  - `naturalLanguageConstraint` string — Required. The natural language constraint of the SemanticGovernancePolicy.
  - `agentIdentity` string — Output only. Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks. For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity Format: `principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME` Example: `principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID`
  - `mcpTools` GoogleCloudAiplatformV1SemanticGovernancePolicyMcpTool[] — Optional. The McpTools that are affected by this policy.
    - `mcpServer` string — Required. The resource name of the McpServer in Agent Registry that is affected by this policy. Format: `projects/{project}/locations/{location}/mcpServers/{mcp_server}`
    - `tools` string[] — Optional. The resource names of the McpTools used by the Agent that is affected by this policy. If not specified, the policy applies to all McpTools in the McpServer.
  - `etag` string — Optional. Used to perform consistent read-modify-write transactions. If provided, the request will only succeed if the etag matches the current value. Otherwise, an ABORTED error will be returned.
  - `updateTime` string, google-datetime — Output only. Timestamp when this SemanticGovernancePolicy was last updated.

## Response `200`

Successful response

---

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