***

title: Configure SDK generation in Postman
updated: 2026-02-04T00:00:00.000Z
max-toc-depth: 2
----------------

The Postman SDK Generator `postman-sdk.config.json` config file contains the configuration used by the Postman SDK CLI to generate SDKs. Power users who require deeper customization can provide a full `postman-sdk.config.json` file. See [Advanced options](#advanced-options) for more information.

At a minimum, set the location of your API specification and the SDK languages you want to generate in the config file:

```json
{
  ...
  "specFilePath": "https://petstore3.swagger.io/api/v3/openapi.json",
  "languages": ["typescript"]
  ...
}
```

The config file contains options that enable you to customize the SDKs you generate. One of the most powerful features of the Postman SDK Generator is the ability to get fine-grained control over the SDK generation process.

<Note>
  The Postman SDK CLI uses a configuration file instead of extensions in your API specification to allow you to keep a separation between your specification and SDK generation. This provides one source for the configuration, and allows you to quickly make changes without having to redeploy your API if your specification is created by your API gateway.
</Note>

## Create and manage the Postman SDK config file

To create the config file, run the [`postman sdk init`](/docs/sdk-generator/sdk-cli/#postman-sdk-init) command.

By default, the config file is located in the `.postman/config.json` root of your project. When you run CLI commands such as [`postman sdk generate`](/docs/sdk-generator/sdk-cli/#postman-sdk-generate), the CLI looks for this config file in the current working directory.

You can change the name and location of the config file by passing the `--config` option to the CLI commands. This supports local and remote config files.

```bash
postman sdk generate --config <PATH_OF_POSTMAN_CONFIG_FILE>
```

<Note>
  The `specFilePath` option in the config file is always relative to the current working directory that the CLI is being run from, not relative to the config file location.
</Note>

## Postman SDK config file structure

The config file defines the SDK to create, along with the configuration based on your API. It also defines sections for generic customizations, language specific customizations, publishing, and configuring validation.

```json
{
  "schemaVersion": "1",
  "workspace": {},
  "entities": {},
  "sdk": {
    "sdkName": "",
    "languages": [
      "typescript"
    ],
    "customizations": {
      "environments": [],
      "license": {
        "type": "NONE"
      },
      "retry": {
        "enabled": true,
        "maxAttempts": 3,
        "retryDelay": 150
      }
    },
    "languageOptions": {
      "typescript": {
        "bundle": true,
        "denoteCommon": false,
        "exportClassDefault": false
      },
      "java": {},
      "python": {},
      "analytics": {
        "enabled": true,
        "exporter": "otlp-http",
        "endpoint": "https://insights.postman.com/v3/traces",
        "headers": {
          "Content-Type": "application/json"
          // any other custom header
        },
        "batchSize": 100,
        "scheduledDelayMillis": 5000,
        "serviceName": "your-sdk"
      }
    }
  }
}
```

## Advanced options

The following topics provide more information about config file sections:

* [Postman SDK core configuration options](/docs/sdk-generator/configure/core-options/)
* [Postman SDK customization options](/docs/sdk-generator/configure/customization-options/)
* [Postman SDK language-specific options](/docs/sdk-generator/configure/language-options/)