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

# POST /v1/{+parent}/configs

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

Creates a new ApiConfig in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `apiConfigId` string

## Request body

- ApigatewayApiConfig — An API Configuration is a combination of settings for both the Managed Service and Gateways serving this API Config.
  - `createTime` string, google-datetime — Output only. Created time.
  - `openapiDocuments` ApigatewayApiConfigOpenApiDocument[] — Optional. OpenAPI specification documents. If specified, grpc_services and managed_service_configs must not be included.
    - `document` ApigatewayApiConfigFile — A lightweight description of a file.
      - `path` string — The file path (full or relative path). This is typically the path of the file when it is uploaded.
      - `contents` string, byte — The bytes that constitute the file.
  - `managedServiceConfigs` ApigatewayApiConfigFile[] — Optional. Service Configuration files. At least one must be included when using gRPC service definitions. See https://cloud.google.com/endpoints/docs/grpc/grpc-service-config#service_configuration_overview for the expected file contents. If multiple files are specified, the files are merged with the following rules: * All singular scalar fields are merged using "last one wins" semantics in the order of the files uploaded. * Repeated fields are concatenated. * Singular embedded messages are merged using these rules for nested fields.
    - `path` string — The file path (full or relative path). This is typically the path of the file when it is uploaded.
    - `contents` string, byte — The bytes that constitute the file.
  - `grpcServices` ApigatewayApiConfigGrpcServiceDefinition[] — Optional. gRPC service definition files. If specified, openapi_documents must not be included.
    - `fileDescriptorSet` ApigatewayApiConfigFile — A lightweight description of a file.
      - `path` string — The file path (full or relative path). This is typically the path of the file when it is uploaded.
      - `contents` string, byte — The bytes that constitute the file.
    - `source` ApigatewayApiConfigFile[] — Optional. Uncompiled proto files associated with the descriptor set, used for display purposes (server-side compilation is not supported). These should match the inputs to 'protoc' command used to generate file_descriptor_set.
      - `path` string — The file path (full or relative path). This is typically the path of the file when it is uploaded.
      - `contents` string, byte — The bytes that constitute the file.
  - `displayName` string — Optional. Display name.
  - `updateTime` string, google-datetime — Output only. Updated time.
  - `name` string — Output only. Resource name of the API Config. Format: projects/{project}/locations/global/apis/{api}/configs/{api_config}
  - `gatewayServiceAccount` string — Immutable. The Google Cloud IAM Service Account that Gateways serving this config should use to authenticate to other services. This may either be the Service Account's email (`{ACCOUNT_ID}@{PROJECT}.iam.gserviceaccount.com`) or its full resource name (`projects/{PROJECT}/accounts/{UNIQUE_ID}`). This is most often used when the service is a GCP resource such as a Cloud Run Service or an IAP-secured service.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'FAILED' | 'DELETING' | 'UPDATING' | 'ACTIVATING' — Output only. State of the API Config.
  - `labels` object — Optional. Resource labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources
  - `serviceConfigId` string — Output only. The ID of the associated Service Config ( https://cloud.google.com/service-infrastructure/docs/glossary#config).

## Response `200`

Successful response

---

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