---
title: "Resolve Agent Connection"
method: POST
path: "/gateways/llms/resolve"
tags: ["Gateway: LLM"]
---

# Resolve Agent Connection

`POST /gateways/llms/resolve`

Resolve an agent's gateway target without exposing a vault secret.

## Request body

- LLMGatewayConnectionResolveRequest
  - `model` string, required
  - `provider_key` string, nullable
  - `connection_slug` string, nullable

## Response `200`

Successful Response

- LLMGatewayConnectionResolveResponse
  - `connection` LLMGatewayConnectionResolution, required — Non-secret result of resolving one agent model connection. The API core chooses and validates the endpoint while it has vault access. The service process receives this route metadata only; provider-key material never crosses that boundary.
    - `namespace` 'builtin' | 'standard' | 'custom', required — Gateway route namespace.
    - `name` string, required
    - `provider_key` string, required
    - `deployment_kind` 'direct' | 'custom' | 'azure' | 'bedrock' | 'sagemaker' | 'vertex_ai' | 'mock', required — How an upstream model deployment is reached.
    - `model` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-20** `7a4b57044657` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/gateways/llms/resolve/post.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenta-ai/apis/agenta-api/revisions/72f2feba8ccb?raw)