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

# Create Pass Through Endpoints

`POST /config/pass_through_endpoint`

## Request

- Base URL: `https://api.vibebrowser.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.vibebrowser.app/config/pass_through_endpoint`
- Auth: one of:
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`

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.dev/vibebrowser/apis/litellm-api.md) · [All operations](https://skmtc.dev/vibebrowser/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vibebrowser/apis/litellm-api/revisions/23d8a3c192b6?raw)
