curl -X GET "https://api.danubeai.com/v1/services/svc_vercel_001/parameter-defaults" \
-H "danube-api-key: YOUR_API_KEY"
{
"service_id": "svc_vercel_001",
"rows": [
{
"id": "pd_org_001",
"user_id": null,
"org_id": "org_acme_001",
"service_id": "svc_vercel_001",
"tool_id": null,
"defaults": {"teamId": "team_acme"},
"updated_at": "2026-09-05T16:40:12.000000Z"
},
{
"id": "pd_user_001",
"user_id": "user_456",
"org_id": null,
"service_id": "svc_vercel_001",
"tool_id": "tool_abc123",
"defaults": {"limit": 50},
"updated_at": "2026-09-11T09:12:03.000000Z"
}
],
"effective": {"teamId": "team_acme"}
}
Services
Get Parameter Defaults
The saved parameter defaults that apply to you on one service, and the merged result
GET
/
v1
/
services
/
{service_id}
/
parameter-defaults
curl -X GET "https://api.danubeai.com/v1/services/svc_vercel_001/parameter-defaults" \
-H "danube-api-key: YOUR_API_KEY"
{
"service_id": "svc_vercel_001",
"rows": [
{
"id": "pd_org_001",
"user_id": null,
"org_id": "org_acme_001",
"service_id": "svc_vercel_001",
"tool_id": null,
"defaults": {"teamId": "team_acme"},
"updated_at": "2026-09-05T16:40:12.000000Z"
},
{
"id": "pd_user_001",
"user_id": "user_456",
"org_id": null,
"service_id": "svc_vercel_001",
"tool_id": "tool_abc123",
"defaults": {"limit": 50},
"updated_at": "2026-09-11T09:12:03.000000Z"
}
],
"effective": {"teamId": "team_acme"}
}
Overview
Parameter defaults are values Danube fills into a tool call when the call leaves them out: Vercel’steamId, a Sentry organization slug, a DigitalOcean app id. An explicit value in the call always wins. This endpoint returns every defaults row that applies to you on one service, your own rows and your organizations’ rows, plus effective, the merged service-wide result.
Precedence, least to most specific:
- Organization, whole service
- Organization, one tool
- You, whole service
- You, one tool
rows but are merged into effective only when their tool matches, so effective here is the service-wide view. The per-tool merge is the defaults field of Describe Tool.
Reads are best-effort: when the lookup fails, rows is [] and effective is {}.
Auth: Required. API key (danube-api-key header) or JWT.
Path Parameters
Response
Every applicable row. Each has
id, user_id (set for your own rows), org_id (set for organization rows), service_id, tool_id (null for a service-wide row), defaults and updated_at.Example
The Python and TypeScript SDKs do not wrap this endpoint yet, and there is no MCP tool for reading defaults.describe_tool on MCP shows the effective defaults for one tool.
curl -X GET "https://api.danubeai.com/v1/services/svc_vercel_001/parameter-defaults" \
-H "danube-api-key: YOUR_API_KEY"
{
"service_id": "svc_vercel_001",
"rows": [
{
"id": "pd_org_001",
"user_id": null,
"org_id": "org_acme_001",
"service_id": "svc_vercel_001",
"tool_id": null,
"defaults": {"teamId": "team_acme"},
"updated_at": "2026-09-05T16:40:12.000000Z"
},
{
"id": "pd_user_001",
"user_id": "user_456",
"org_id": null,
"service_id": "svc_vercel_001",
"tool_id": "tool_abc123",
"defaults": {"limit": 50},
"updated_at": "2026-09-11T09:12:03.000000Z"
}
],
"effective": {"teamId": "team_acme"}
}
