---
title: "Test a Provider Configuration"
method: POST
path: "/v1/provider-configurations/{id}/test"
tags: ["Provider Configurations API"]
---

# Test a Provider Configuration

`POST /v1/provider-configurations/{id}/test`

Use this endpoint to test connectivity, authentication, and end-to-end communication with the configured provider.

## Path parameters

- `id` string, uuid, required

## Response `200`

Indicates that the request was successful and the response contains the requested data.

- ProviderConfigTestResultOutput
  - `completedAt` string, date-time — Timestamp when the test finished.
  - `durationMs` integer — Total test duration in milliseconds.
  - `overallStatus` string — Aggregate result: `passed` if all stages succeeded, `failed` if any stage failed.
  - `providerConfigId` string, uuid — ID of the provider configuration that was tested.
  - `providerId` string — Catalog provider ID.
  - `stages` StageTestResultOutput[] — Ordered list of test stages with individual results.
    - `details` object — Additional details about the stage result.
    - `durationMs` integer — Stage duration in milliseconds.
    - `error` string — Error message if the stage failed.
    - `message` string — Human-readable description of the stage result.
    - `name` string — Name of the test stage.
    - `status` string — Stage result: `passed` or `failed`.
  - `startedAt` string, date-time — Timestamp when the test started.
  - `summary` string — Human-readable summary of the test results.

## Other responses

- `400` — Indicates that the request was malformed or contained invalid parameters.
- `404` — Indicates that the requested resource could not be found.
- `422` — Indicates that the request was well-formed but contains semantic errors that prevent processing.
- `500` — Indicates an unexpected internal error. If this persists, please contact support.

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)