Upsert Integration Key

Create or update an integration key for a provider

Endpoint

POST https://api.ugc.inc/org/integration-key/upsert

Overview

Create or update an integration key for a specific AI provider. If a key already exists for the provider, it will be updated. Integration keys are used automatically by automation nodes (LLM, image generation, video generation, custom model).

Request Body

provider · string · required

The provider to set the key for. One of: fal, openrouter

key · string · required

The API key value for the provider

Response

data · IntegrationKey

The created or updated integration key (with masked value)

Show IntegrationKey properties

id · string

Unique integration key identifier

provider · string

Provider name

maskedKey · string

Masked key value showing only the first 4 and last 4 characters

created_at · string

ISO 8601 timestamp of when the key was created

cURL

curl -X POST https://api.ugc.inc/org/integration-key/upsert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "openrouter",
    "key": "sk-or-abc123..."
  }'

Success Response

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "provider": "openrouter",
    "maskedKey": "sk-o...8xYz",
    "created_at": "2024-01-15T10:30:00.000Z"
  }
}