Update a secret set
Updated
Adds, changes, or removes several keys in a secret set in one change.
Preview documentation
https://preview.ai.agora.io/conversational-ai/v1/projects/{appid}/secrets/{name}Use this endpoint to rotate keys that must change together. Pass a string to add or replace a key, or null to remove it. Keys you omit don't change. To change one key, set the key instead. To replace the whole set, use Replace a secret set.
Running sessions keep the values they resolved when they started. New sessions use the new values.
appidstringThe App ID of your project.
namestringThe name of the secret set.
If-MatchstringThe ETag value from the most recent response for this resource. When you include it, the request fails with 412 and reason PreconditionFailed if the resource has changed since then. Use it to avoid overwriting a concurrent change.
secretsobjectThe keys to change. A string value adds the key, or replaces its value if the key exists. A null value removes the key. Keys you omit don't change.
[key: string]string | nullResponse Body
The secret set was updated. The response body lists its keys.
Response Headers
namestringThe name of the secret set.
keysarray<string>The names of the keys in the set. Values are never returned.
create_tsintegerThe time the set was created, as a Unix timestamp in seconds.
update_tsintegerThe time the set was last updated, as a Unix timestamp in seconds.
Request examples
curl -X PATCH 'https://preview.ai.agora.io/conversational-ai/v1/projects/string/secrets/string' \ -H 'Content-Type: application/json' \ -d '{ "secrets": { "llm": "<your_new_llm_api_key>", "tts": "<your_new_tts_api_key>", "asr": null }}'Response example
{ "name": "string", "keys": [ "string" ], "create_ts": 0, "update_ts": 0}