Vault secrets
Delete
Permanently delete a single secret from a Nairi vault by ID. Irreversible — any agent currently relying on the secret value will lose access on next run.
DELETE /api/public/v1/vaults/{vault_id}/secrets/{secret_id}Example
curl -X DELETE https://api.nairi.ai/api/public/v1/vaults/VAULT_ID/secrets/SECRET_ID \
-H "Authorization: Bearer $NAIRI_API_KEY"await fetch(
`https://api.nairi.ai/api/public/v1/vaults/${vaultId}/secrets/${secretId}`,
{
method: "DELETE",
headers: {
Authorization: `Bearer ${process.env.NAIRI_API_KEY}`,
},
},
);require "net/http"
require "uri"
uri = URI("https://api.nairi.ai/api/public/v1/vaults/#{vault_id}/secrets/#{secret_id}")
req = Net::HTTP::Delete.new(uri)
req["Authorization"] = "Bearer #{ENV['NAIRI_API_KEY']}"
Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }import os
import requests
requests.delete(
f"https://api.nairi.ai/api/public/v1/vaults/{vault_id}/secrets/{secret_id}",
headers={"Authorization": f"Bearer {os.environ['NAIRI_API_KEY']}"},
)package main
import (
"net/http"
"os"
)
func main() {
vaultID := os.Getenv("VAULT_ID")
secretID := os.Getenv("SECRET_ID")
req, _ := http.NewRequest(
"DELETE",
"https://api.nairi.ai/api/public/v1/vaults/"+vaultID+"/secrets/"+secretID,
nil,
)
req.Header.Set("Authorization", "Bearer "+os.Getenv("NAIRI_API_KEY"))
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
}Response: 204 No Content
Update
Rotate a vault secret's value or change the list of allowed destination domains where it can be injected at runtime. Returns the updated secret object.
Overview
Discover the LLM providers, GitHub installations, and other integrations connected to your Nairi organization through the REST API. Read-only endpoints.