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

# POST /v1/{+parent}/services

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

Creates a new Service in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `requestId` string
- `serviceId` string

## Request body

- Service — Represents a user-defined Service.
  - `updateTime` string, google-datetime — Output only. Update time.
  - `agentSpec` AgentSpec — The spec of the agent.
    - `type` 'TYPE_UNSPECIFIED' | 'NO_SPEC' | 'A2A_AGENT_CARD' — Required. The type of the agent spec content.
    - `content` object — Optional. The content of the Agent spec in the JSON format. This payload is validated against the schema for the specified type. The content size is limited to `10KB`.
  - `createTime` string, google-datetime — Output only. Create time.
  - `name` string — Identifier. The resource name of the Service. Format: `projects/{project}/locations/{location}/services/{service}`.
  - `description` string — Optional. User-defined description of an Service. Can have a maximum length of `2048` characters.
  - `displayName` string — Optional. User-defined display name for the Service. Can have a maximum length of `63` characters.
  - `mcpServerSpec` McpServerSpec — The spec of the MCP Server.
    - `type` 'TYPE_UNSPECIFIED' | 'NO_SPEC' | 'TOOL_SPEC' — Required. The type of the MCP Server spec content.
    - `content` object — Optional. The content of the MCP Server spec. This payload is validated against the schema for the specified type. The content size is limited to `10KB`.
  - `endpointSpec` EndpointSpec — The spec of the endpoint.
    - `type` 'TYPE_UNSPECIFIED' | 'NO_SPEC' — Required. The type of the endpoint spec content.
    - `content` object — Optional. The content of the endpoint spec. Reserved for future use.
  - `registryResource` string — Output only. The resource name of the resulting Agent, MCP Server, or Endpoint. Format: * `projects/{project}/locations/{location}/mcpServers/{mcp_server}` * `projects/{project}/locations/{location}/agents/{agent}` * `projects/{project}/locations/{location}/endpoints/{endpoint}`
  - `interfaces` Interface[] — Optional. The connection details for the Service.
    - `protocolBinding` 'PROTOCOL_BINDING_UNSPECIFIED' | 'JSONRPC' | 'GRPC' | 'HTTP_JSON' — Required. The protocol binding of the interface.
    - `url` string — Required. The destination URL.

## Response `200`

Successful response

---

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