Secrets

App secrets and API keys

Delete

DELETE

/api/v1/secrets/:id

Delete a stored secret by key.

Parameters

Field	Type	Required
`appInstallId`	`string`	Yes
`serverId`	`string`	Yes
`key`	`string`	Yes

Example

Terminal

curl -X DELETE "https://start.chat/api/v1/secrets/{id}" \
  -H "Authorization: Bearer sk_live_xxx"

import { setup, mutate } from '@start-chat/sdk'

await setup({ apiKey: 'sk_live_xxx' })

const result = await mutate.secret.delete({
  appInstallId: 'ai_abc123',
  serverId: 'srv_abc123',
  key: 'API_TOKEN',
})

Response

{
  "ok": true,
  "data": {
    "id": "secret_abc123",
    "createdAt": 1709251200000
  }
}

Set

POST

/api/v1/secrets/set

Store a secret value (API key, token) for an installed app.

Parameters

Field	Type	Required
`appInstallId`	`string`	Yes
`serverId`	`string`	Yes
`key`	`string`	Yes
`value`	`string`	Yes

Example

Terminal

curl -X POST "https://start.chat/api/v1/secrets/set" \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "appInstallId": "ai_abc123",
    "serverId": "srv_abc123",
    "key": "API_TOKEN",
    "value": "secret_value"
  }'

import { setup, mutate } from '@start-chat/sdk'

await setup({ apiKey: 'sk_live_xxx' })

const result = await mutate.secret.set({
  appInstallId: 'ai_abc123',
  serverId: 'srv_abc123',
  key: 'API_TOKEN',
  value: 'secret_value',
})

Response

{
  "ok": true,
  "data": {
    "id": "secret_abc123",
    "createdAt": 1709251200000
  }
}

Roles

Servers