---
title: "Create Pass Through Endpoints"
method: POST
path: "/config/pass_through_endpoint"
---

# Create Pass Through Endpoints

`POST /config/pass_through_endpoint`

Create new pass-through endpoint

## Request body

- PassThroughGenericEndpoint
  - `id` string, nullable — Optional unique identifier for the pass-through endpoint. If not provided, endpoints will be identified by path for backwards compatibility.
  - `path` string, required — The route to be added to the LiteLLM Proxy Server.
  - `target` string, required — The URL to which requests for this path should be forwarded.
  - `headers` object — Key-value pairs of headers to be forwarded with the request. You can set any key value pair here and it will be forwarded to your target endpoint
  - `default_query_params` object — Key-value pairs of default query parameters to be sent with every request to this endpoint. These can be overridden by client-provided query parameters. For example: {'key': 'default_value', 'api_version': '2023-01'}
  - `include_subpath` boolean — If True, requests to subpaths of the path will be forwarded to the target endpoint. For example, if the path is /bria and include_subpath is True, requests to /bria/v1/text-to-image/base/2.3 will be forwarded to the target endpoint.
  - `cost_per_request` number — The USD cost per request to the target endpoint. This is used to calculate the cost of the request to the target endpoint.
  - `auth` boolean — Whether authentication is required for the pass-through endpoint. If True, requests to the endpoint will require a valid LiteLLM API key.
  - `guardrails` object, nullable — Guardrails configuration for this passthrough endpoint. Dict keys are guardrail names, values are optional settings for field targeting. When set, all org/team/key level guardrails will also execute. Defaults to None (no guardrails execute).
  - `is_from_config` boolean — True if this endpoint is defined in the config file, False if from DB. Config-defined endpoints cannot be edited via the UI.
  - `methods` string[], nullable — List of HTTP methods this endpoint handles (e.g., ['GET', 'POST']). If None or empty, all methods (GET, POST, PUT, DELETE, PATCH) are supported for backward compatibility. This allows the same path to have different targets for different HTTP methods.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/1e929292ddd5/schema)