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

# POST /v1/{+parent}/agents

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

Creates an agent.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudAiplatformV1Agent — A Vertex agent contains instructions and configurations for the LLM to execute a certain task.
  - `base_environment` unknown
  - `base_agent` string — Required. The base agent for the agent. Supported values: * `antigravity-preview-05-2026`
  - `created` string, google-datetime — Output only. The time the agent was created.
  - `tools` GoogleCloudAiplatformV1AgentTool[] — Optional. The tools available to the agent.
    - `name` string — Optional. The name of the MCP server. Only applicable when `type` is `mcp_server`.
    - `url` string — Optional. The URL for the MCP server endpoint. Only applicable when `type` is `mcp_server`.
    - `headers` object — Optional. The headers for the MCP server, such as for authentication. Only applicable when `type` is `mcp_server`.
    - `type` string — Required. The type of the tool. Supported types: * `code_execution` * `filesystem` * `google_search` * `mcp_server` * `url_context`
  - `metadata` object — Optional. The metadata for the agent.
  - `system_instruction` string — Optional. The instructions for the agent to follow. These instructions are passed to the LLM as a system instruction.
  - `name` string — Identifier. The resource name of the agent. Format: `projects/{project}/locations/{location}/agents/{agent}`.
  - `id` string — Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.
  - `updated` string, google-datetime — Output only. The time the agent was last updated.
  - `object` string — Output only. The object type of the resource. For agents, the value is `agent`.
  - `description` string — Optional. The description of the agent.

## 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)