---
title: "Probe Provider"
method: POST
path: "/providers/probe"
tags: ["Secrets"]
---

# Probe Provider

`POST /providers/probe`

## Request body

- ProbeProviderRequest — The credential to test. It is spent on one read and never persisted. `kind` is a StandardProviderKind or CustomProviderKind value; `provider` carries the same field vocabulary the vault stores, so a card can probe what it is about to save without reshaping it.
  - `kind` string, required — Provider kind, e.g. 'openai', 'azure', 'custom'.
  - `provider` ProviderCredentials, required — Credentials in transit only. Never persisted here, never logged, never echoed. `key` is a `SecretStr` and `extras` is kept out of `repr`, so an accidental log line or traceback that carries this object cannot print the credential. Unwrap the key with `.get_secret_value()` at the point it is put on the wire, never earlier.
    - `key` string, password, nullable
    - `url` string, nullable
    - `version` string, nullable
    - `extras` object, nullable

## Response `200`

Successful Response

- ProbeProviderResponse
  - `credential` CredentialResult, required
    - `status` 'valid' | 'invalid' | 'unknown', required — Did the provider accept this credential? `unknown` is an honest answer, not a failure: it means Agenta found no free, read-only endpoint that proves the credential works. A public catalog endpoint answering successfully never raises the status above `unknown`.
    - `message` string, required
  - `discovery` DiscoveryResult, required
    - `status` 'fetched' | 'unsupported' | 'failed', required — Which model identifiers did the provider return? `unsupported` means the provider offers no model-list endpoint; `failed` means one exists but this attempt did not get an answer. Either way the caller keeps the shipped catalog rather than narrowing the user's model choice.
    - `models` string[]
  - `fetched_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.net/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/revisions/e1ffc32fa59c/schema)