---
title: "POST /v1/services/{serviceName}/configs:submit"
method: POST
path: "/v1/services/{serviceName}/configs:submit"
tags: ["services"]
---

# POST /v1/services/{serviceName}/configs:submit

`POST /v1/services/{serviceName}/configs:submit`

Creates a new service configuration (version) for a managed service based on user-supplied configuration source files (for example: OpenAPI Specification). This method stores the source configurations as well as the generated service configuration. To rollout the service configuration to other services, please call CreateServiceRollout. Only the 100 most recent configuration sources and ones referenced by existing service configurtions are kept for each service. The rest will be deleted eventually. Operation

## Path parameters

- `serviceName` string, required

## Request body

- SubmitConfigSourceRequest — Request message for SubmitConfigSource method.
  - `configSource` ConfigSource — Represents a source file which is used to generate the service configuration defined by `google.api.Service`.
    - `files` ConfigFile[] — Set of source configuration files that are used to generate a service configuration (`google.api.Service`).
      - `fileType` 'FILE_TYPE_UNSPECIFIED' | 'SERVICE_CONFIG_YAML' | 'OPEN_API_JSON' | 'OPEN_API_YAML' | 'FILE_DESCRIPTOR_SET_PROTO' | 'PROTO_FILE' — The type of configuration file this represents.
      - `fileContents` string, byte — The bytes that constitute the file.
      - `filePath` string — The file name of the configuration file (full or relative path).
    - `id` string — A unique ID for a specific instance of this message, typically assigned by the client for tracking purpose. If empty, the server may choose to generate one instead.
  - `validateOnly` boolean — Optional. If set, this will result in the generation of a `google.api.Service` configuration based on the `ConfigSource` provided, but the generated config and the sources will NOT be persisted.

## Response `200`

Successful response

---

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