---
title: "Generate React HTTP client from GraphQL schema"
method: POST
path: "/api/graphql/react"
tags: ["GraphQL"]
---

# Generate React HTTP client from GraphQL schema

`POST /api/graphql/react`

## Request body

- GraphQLReactRequest
  - `graphQLSchema` string, nullable, required — Inline GraphQL SDL schema content.
  - `documentation` boolean, nullable
  - `fragments` boolean, nullable
  - `optionsObjectThreshold` integer, nullable
  - `customScalars` object, nullable — Map GraphQL scalar names to a target language type. Keys are scalar names (e.g. "DateTime", "BigInt"); values are slug identifiers — see CustomScalarRegistry.
  - `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
  - `baseUrlEnvVar` string, nullable
  - `useTanStackQuery` boolean, nullable
  - `useMiddleware` boolean, nullable
  - `useTypesBarrel` boolean, nullable
  - `responseDateTransformation` boolean, 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)