For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Get Started
    • Introduction
    • Quickstart
    • Authentication
  • API Reference
      • GETList Provider Keys
      • PUTPut Provider Key
      • DELDelete Provider Key
  • Python SDK
    • Install
    • Usage
    • Errors
  • CLI
    • Overview
LogoLogo
API Referenceprovider-keys

Put Provider Key

PUT
/api/v1/provider-keys/:provider
PUT
/api/v1/provider-keys/:provider
$curl -X PUT https://api.onepin.ai/api/v1/provider-keys/elevenlabs \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "data": {
3    "provider": "elevenlabs",
4    "credentials_schema": {},
5    "configured": true,
6    "is_valid": true,
7    "validated_at": "2024-01-15T09:30:00Z",
8    "key_preview": "abcd1234efgh5678",
9    "status": "valid"
10  },
11  "meta": {
12    "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
13    "timestamp": "2024-01-15T09:30:00Z"
14  }
15}

Create or replace a BYOK provider key for the current workspace.

POD-301: gated by byok_enabled feature flag on the workspace owner’s plan. Free plan rejects with 403 FEATURE_NOT_IN_PLAN.

Was this page helpful?
Previous

Delete Provider Key

Next
Built with

Authentication

AuthorizationBearer
Clerk JWT token

Path parameters

providerenumRequired

Headers

X-Workspace-Idstring or nullOptional

Request

This endpoint expects a map from strings to any.

Response

Successful Response
dataobject
metaobject

Errors

422
Unprocessable Entity Error