curl -X PUT "https://api.danubeai.com/v1/services/svc_vercel_001/parameter-defaults" \
-H "danube-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"defaults": {"teamId": "team_acme"},
"scope": "user"
}'
{
"id": "pd_user_002",
"user_id": "user_456",
"org_id": null,
"service_id": "svc_vercel_001",
"tool_id": null,
"defaults": {"teamId": "team_acme"},
"created_at": "2026-09-12T10:04:55.000000Z",
"updated_at": "2026-09-12T10:04:55.000000Z"
}
Services
Set Parameter Defaults
Create or replace the saved defaults for a service, or for one of its tools
PUT
/
v1
/
services
/
{service_id}
/
parameter-defaults
curl -X PUT "https://api.danubeai.com/v1/services/svc_vercel_001/parameter-defaults" \
-H "danube-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"defaults": {"teamId": "team_acme"},
"scope": "user"
}'
{
"id": "pd_user_002",
"user_id": "user_456",
"org_id": null,
"service_id": "svc_vercel_001",
"tool_id": null,
"defaults": {"teamId": "team_acme"},
"created_at": "2026-09-12T10:04:55.000000Z",
"updated_at": "2026-09-12T10:04:55.000000Z"
}
Overview
Saves the parameters you always pass to a service, so future calls can leave them out. One row exists per scope, service and tool (or whole service); this request creates it or replaces itsdefaults in full.
At execution time the defaults are merged under the call’s input. A parameter the call omits, or sends as null or an empty string, takes the default; any other explicit value wins. The execution response lists what was filled in under defaults_applied.
Defaults are identifiers and settings, never credentials. A default is refused with 400 when its key matches secret, token, password, api_key, authorization, private_key or credential, or when its value starts like a known secret (sk_live_, sk_test_, rk_live_, rk_test_, whsec_, ghp_, gho_, github_pat_, xoxa-, xoxb-, xoxp-, an AKIA access key id, or a JWT). Store those with Store Credential instead.
Auth: Required. API key (danube-api-key header) or JWT. Organization-wide defaults need the owner or admin role in that organization, or the response is 403.
Path Parameters
Body Parameters
user for your own defaults, org for organization-wide defaults. Anything else is 400.Response
The stored row.Example
The Python and TypeScript SDKs do not wrap this endpoint yet.curl -X PUT "https://api.danubeai.com/v1/services/svc_vercel_001/parameter-defaults" \
-H "danube-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"defaults": {"teamId": "team_acme"},
"scope": "user"
}'
{
"id": "pd_user_002",
"user_id": "user_456",
"org_id": null,
"service_id": "svc_vercel_001",
"tool_id": null,
"defaults": {"teamId": "team_acme"},
"created_at": "2026-09-12T10:04:55.000000Z",
"updated_at": "2026-09-12T10:04:55.000000Z"
}
MCP Tool
This endpoint is also available as theset_parameter_defaults MCP tool, which always writes user scope:
result = await mcp.call_tool("set_parameter_defaults", {
"service_id": "svc_vercel_001",
"defaults": {"teamId": "team_acme"},
"tool_id": None
})
