Update a Secret

In this example we will update a secret with a new phrase "This is a new big secret!" as the name demosecret.

Click on the Secrets menu under Orchestration.

Find the secret you want to update and then click on the Edit icon in that row.

You can now add your new value to the secret name.

Warning

You will not see the secret again, so make sure you type it correctly.

You can update the value with a new one again, but you will not be able to see the original value.

When updated you can click the Save button to save it.

Congratulations, you now have updated a value in an existing secret variable.

API cURL Example
1
2
3
4
5
6
7
8
curl -X "POST" \
"https://<url.kelvin.ai>/api/v4/secrets/demosecret/update" \
-H "Authorization: Bearer <Your Current Token>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
        "value": "This is a new big secret!"
    }'

The response will look like this;

API cURL Example Response
1
2
3
4
5
6
7
{
"name": "demosecret",
"created_by": "krn:user:example@kelvin.ai",
"created": "2025-11-24T07:05:46.789693Z",
"updated": "2025-11-24T07:06:03.694621Z",
"updated_by": "krn:user:example@kelvin.ai"
}
API Client (Python) Example
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
from kelvin.api.client import Client

# Login
client = Client(url="https://<url.kelvin.ai>", username="<your_username>"})
client.login(password="<your_password>")

# Update Secret
response = client.secret.update_secret(secret_name="demosecret", data={"value": "Nh9Noq%QWNaJim%uAe9r"})

print(response)

You will see the output like this;

API Client (Python) Example Response
1
name='demosecret' created=datetime.datetime(2025, 11, 24, 7, 5, 46, 789693, tzinfo=TzInfo(UTC)) created_by='krn:user:example@kelvin.ai' updated=datetime.datetime(2025, 11, 24, 7, 17, 56, 245169, tzinfo=TzInfo(UTC)) updated_by='krn:user:example@kelvin.ai'
Kelvin SDK Command Line Example
1
kelvin secret update --value="This is a new big secret!" demosecret

If everything went well you will get the confirmation response like this;

Kelvin SDK Command Line Output
1
2
3
[kelvin.sdk][2025-11-24 07:21:26][I] Updating secret "demosecret" on the platform
[kelvin.sdk][2025-11-24 07:21:26][I] Fetching credentials from keyring
[kelvin.sdk][2025-11-24 07:21:28][R] Secret "demosecret" successfully updated on the platform