---
title: "Validate Provider Credential"
method: POST
path: "/v1/provider-credentials/{slot}/validate"
tags: ["provider-credentials"]
---

# Validate Provider Credential

`POST /v1/provider-credentials/{slot}/validate`

## Request

- Base URL: `https://api.cyberdesk.io`
- URL: `https://api.cyberdesk.io/v1/provider-credentials/{slot}/validate`
- Auth: HTTP bearer

Make a minimal live call with the stored credential and update its status.

## Path parameters

- `slot` 'anthropic' | 'openai' | 'google' | 'aws_bedrock', required

## Headers

- `Idempotency-Key` string

## Response `200`

Successful Response

- ProviderCredentialValidationResponse
  - `slot` 'anthropic' | 'openai' | 'google' | 'aws_bedrock', required
  - `ok` boolean, required
  - `checks` ProviderCredentialValidationCheck[], required
    - `check` string, required
    - `label` string, required
    - `ok` boolean, required
    - `model` string, nullable
    - `location` string, nullable
    - `error` string, nullable
    - `is_auth_error` boolean
  - `credential` ProviderCredentialResponse, required: State of one BYOK slot. Never includes secret material.
    - `slot` 'anthropic' | 'openai' | 'google' | 'aws_bedrock', required
    - `display_name` string, required
    - `source` 'cyberdesk' | 'organization', required
    - `covered_providers` string[], required
    - `status` 'active' | 'invalid' | 'missing'
    - `auth_type` 'api_key' | 'service_account_json' | 'aws_bedrock_api_key' | 'aws_iam'
    - `display_metadata` ProviderCredentialDisplayMetadata: Non-secret metadata shown in the dashboard.
      - `key_last4` string, nullable
      - `project_id` string, nullable
      - `client_email` string, nullable
      - `aws_region` string, nullable
      - `access_key_id_last4` string, nullable
    - `last_error` string, nullable
    - `activated_at` string, date-time, nullable
    - `last_validated_at` string, date-time, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `5579352ae05e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/changes/v1/provider-credentials/:slot/validate/post.md)

---

[API](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud.md) - [All operations](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/revisions/5579352ae05e?raw)