---
title: "Generate Python httpx client from OpenAPI spec"
method: POST
path: "/api/openapi/python-httpx"
tags: ["OpenApi"]
---

# Generate Python httpx client from OpenAPI spec

`POST /api/openapi/python-httpx`

## Request body

- OpenApiPythonHttpxRequest
  - `openApiSpec` string, nullable — Inline OpenAPI spec content (YAML or JSON). Either this or OpenApiSpecUrl is required.
  - `openApiSpecUrl` string, nullable — URL to fetch the OpenAPI spec from. Either this or OpenApiSpec is required.
  - `strictValidation` boolean, nullable
  - `documentation` boolean, nullable
  - `optionsObjectThreshold` integer, nullable
  - `typeMappings` object, nullable — Override the target language type for an OpenAPI primitive/format. Keys are mapping slugs (int64, decimal, date-time, date) — see TypeMappingRegistry for accepted slug→target combos.
  - `includeTags` string[], nullable — Only generate operations whose service tag matches one of these values (case-insensitive).
  - `errorHandling` ErrorHandlingOptions
    - `enabled` boolean, nullable
    - `returnNullForStatusCodes` integer[], nullable
    - `throwForStatusCodes` integer[], nullable
  - `timeout` TimeoutOptions
    - `seconds` number, double, nullable
    - `connect` number, double, nullable
    - `read` number, double, nullable
    - `write` number, double, nullable
  - `bearerAuth` BearerAuthOptions
    - `envVarName` string, nullable
    - `headerName` string, nullable
  - `basicAuth` BasicAuthOptions
    - `usernameEnvVar` string, nullable
    - `passwordEnvVar` string, nullable
  - `retries` RetryOptions
    - `maxAttempts` integer, nullable
    - `baseDelaySeconds` number, double, nullable
    - `maxDelaySeconds` number, double, nullable
    - `retryStatusCodes` integer[], nullable
  - `customHeaders` CustomHeaderOption[], nullable
    - `headerName` string, nullable
    - `envVarName` string, nullable
  - `generateSyncMethods` boolean, nullable
  - `useCamelCaseAliases` boolean, nullable
  - `baseUrlEnvVar` string, nullable

## Response `200`

OK

- CodeGenerationResult
  - `executionTimeInMilliseconds` integer
  - `files` CodeFileResult[], nullable
    - `name` string, nullable
    - `path` string, nullable
    - `content` string, nullable
  - `warnings` string[], nullable
  - `additionalInfo` AdditionalInfo
    - `message` string, nullable, required
    - `level` string, nullable — Severity level: info, warning, or critical
    - `actionUrl` string, nullable — Optional URL for the client to act on (e.g., migration guide, changelog)

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/metaengine/apis/metaengine-api.md) · [All operations](https://skmtc.dev/metaengine/apis/metaengine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/metaengine/metaengine-api/revisions/7bba577610ce/schema)