MCP configs
Delete
Permanently delete an MCP config from your Nairi organization. Fails if the config is still assigned to any agent — unassign first, then retry.
DELETE /api/public/v1/artifacts/mcp-configs/{config_id}Example
curl -X DELETE https://api.nairi.ai/api/public/v1/artifacts/mcp-configs/CONFIG_ID \
-H "Authorization: Bearer $NAIRI_API_KEY"await fetch(
`https://api.nairi.ai/api/public/v1/artifacts/mcp-configs/${configId}`,
{
method: "DELETE",
headers: {
Authorization: `Bearer ${process.env.NAIRI_API_KEY}`,
},
},
);require "net/http"
require "uri"
uri = URI("https://api.nairi.ai/api/public/v1/artifacts/mcp-configs/#{config_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/artifacts/mcp-configs/{config_id}",
headers={"Authorization": f"Bearer {os.environ['NAIRI_API_KEY']}"},
)package main
import (
"net/http"
"os"
)
func main() {
configID := os.Getenv("CONFIG_ID")
req, _ := http.NewRequest(
"DELETE",
"https://api.nairi.ai/api/public/v1/artifacts/mcp-configs/"+configID,
nil,
)
req.Header.Set("Authorization", "Bearer "+os.Getenv("NAIRI_API_KEY"))
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
}Deletion fails with 400 Bad Request if the config is assigned to any agent. Unassign it from every agent first.
Response: 204 No Content
Error responses
| HTTP | Body | When |
|---|---|---|
400 | {"error":"cannot delete MCP config: still assigned to N agent(s)"} | The config is still attached to one or more agents. |
404 | {"error":"MCP config not found"} | No config with that ID exists in the calling organization. |
Update
Replace an MCP config's metadata and JSON content in your Nairi organization. Update the server definition without changing agent attachments.
Overview
What skills are and how to package reusable capabilities for agents. Upload, version, and assign skill archives across your Nairi organization via API.