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
string
required
The service UUID or slug. Unknown services return
404.Response
string
The service UUID, resolved from a slug when one was given
array
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.object
The service-wide rows merged in precedence order, as parameter name to value
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"}
}