Delete a key

Deletes the key and every value it had. From the next Turn on, its hosts leave the agent's allowed hosts unless the agent's own list has them. Requires env_vars:write.

DELETE/agents/{agentId}/keys/{name}

Authorization

AuthorizationBearer <token>

Path parameters

agentIdstringrequired

format: "uuid"

namestringrequired

pattern: "^[A-Z][A-Z0-9_]*$"

Headers

Salambo-Clientstring

Which published Salambo client sent the request, as cli/<version> or sdk/<version>. The CLI and SDK send it on every request; a request without it, or with a value in another shape, is served as usual. The API refuses a CLI below its minimum supported version with 426.

maxLength: 100

Response

application/json

Delete result

object

Additional properties are allowed.

curl --request DELETE \
  --url 'https://YOUR_SALAMBO_BASE_URL/api/v1/agents/{agentId}/keys/{name}' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Replace placeholders with your values.

Response

{}