---
title: "Store a write-only hosted AI provider credential"
method: POST
path: "/v1/hosted-ai-credentials"
---

# Store a write-only hosted AI provider credential

`POST /v1/hosted-ai-credentials`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/hosted-ai-credentials`
- Auth: none declared

Stores an encrypted credential in pending_validation status. The secret is accepted only in this request and is never returned. A selected BYOK component never falls back to platform credentials.

## Request body

- object
  - `component` 'stt' | 'llm' | 'tts', required
  - `organization_id` string, required
  - `project_id` string, required
  - `provider` string, required
  - `secret` string, required

## Response `201`

Credential metadata in pending validation

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/148c7e111260?raw)
