Obtener cuenta y uso
GET /v1/me — el workspace, la clave de API y el plan detrás de una clave, más el uso de este período de facturación. Verifica una clave en CI y vigila tu cuota desde el código.
GET https://api.dcision.io/v1/meDevuelve a quién pertenece una clave de API —su workspace, la propia clave y el plan— y las decisiones facturables usadas en el período de facturación actual. Úsalo para verificar una clave en CI o al arrancar, y para mostrar la cuota o alertar sobre ella desde tu propio código.
Solicitud
Sin parámetros y sin cuerpo. Autentícate con las mismas claves de API que las decisiones:
curl https://api.dcision.io/v1/me \
-H "Authorization: Bearer $DCISION_API_KEY"Respuesta
{
"workspace": { "id": "4c8f2a91-6d3b-4e7a-9f15-2b0c7d8e6a43", "name": "Acme", "external_id": null, "parent": null },
"workspace_usage": null,
"api_key": {
"id": "key_7Hq2Lm9Xc4Rv1Tz8Wn3B",
"name": "Production",
"prefix": "dcs_live_9fK2…0Ad2",
"environment": "live"
},
"plan": {
"id": "growth",
"name": "Growth",
"rate_limit_per_minute": 2000,
"max_decisions": null,
"log_retention_days": 30,
"hard_cap": false
},
"usage": {
"used": 1284311,
"included": 10000000,
"period_start": "2026-10-01T00:00:00.000Z",
"period_end": "2026-11-01T00:00:00.000Z"
}
}| Campo | Tipo | Descripción |
|---|---|---|
workspace.id | string | El ID del workspace. |
workspace.name | string | El nombre del workspace. |
workspace.external_id | string | null | Modo socio: con el header Dcision-Workspace, el external_id del subespacio; si no, null. |
workspace.parent | object | null | Con el header Dcision-Workspace: { "id", "name" } de tu workspace, que paga el subespacio. plan y usage son entonces los tuyos. |
workspace_usage | object | null | Con el header Dcision-Workspace: { "used", "limit", "period_start", "period_end" }, las ejecuciones facturables del subespacio en este ciclo y su límite (null = ninguno). |
api_key.id | string | El ID de la clave (key_…). |
api_key.name | string | El nombre dado a la clave en API Keys. |
api_key.prefix | string | La clave enmascarada, como se muestra en la app; nunca el secreto completo. |
api_key.environment | string | live o test. |
plan.id | string | genesis, developer, growth o enterprise. |
plan.name | string | El nombre visible del plan. |
plan.rate_limit_per_minute | integer | Solicitudes por minuto permitidas para el workspace; consulta Rate limits. |
plan.max_decisions | integer o null | Decisiones que puede tener el workspace; null es ilimitado. |
plan.log_retention_days | integer | Cuánto tiempo conserva el plan las ejecuciones. |
plan.hard_cap | boolean | true cuando el plan no puede continuar con créditos: las llamadas se bloquean con 402 QUOTA_EXCEEDED una vez agotado el volumen incluido. false en Genesis, Developer y Growth: superado el volumen incluido, usan créditos. |
usage.used | integer | Decisiones facturables en el período actual. |
usage.included | integer | Decisiones incluidas en el período actual; en los planes anuales, la bolsa de todo el año. |
usage.period_start | string | Inicio del período de facturación actual, ISO 8601. |
usage.period_end | string | Fin del período de facturación actual, ISO 8601. |
El período de facturación es el ciclo de la suscripción en los planes de pago y el mes calendario en UTC en Genesis; consulta Planes, cuotas y facturación.
Ejemplos
Haz fallar pronto un job de CI cuando la clave es incorrecta:
dcision_me=$(curl -sf https://api.dcision.io/v1/me -H "Authorization: Bearer $DCISION_API_KEY") \
|| { echo "Invalid Dcision API key" >&2; exit 1; }
echo "$dcision_me" | jq -r '"\(.workspace.name) · \(.api_key.environment) · \(.plan.name)"'Avisa antes de que se agote el volumen incluido (superado ese volumen, las decisiones usan créditos):
const me = await fetch("https://api.dcision.io/v1/me", {
headers: { Authorization: `Bearer ${process.env.DCISION_API_KEY}` },
}).then((response) => response.json());
const share = me.usage.used / me.usage.included;
if (share >= 0.9) alert(`Dcision: ${Math.round(share * 100)}% of the included volume used`);Errores
| Estado | Código | Cuándo |
|---|---|---|
| 401 | INVALID_API_KEY | La clave falta, está mal formada, es desconocida o fue revocada. |
| 429 | RATE_LIMITED | Demasiadas solicitudes de lectura en el minuto actual. |
Los endpoints de lectura —GET /v1/me y GET /v1/executions— comparten una ventana de rate limit propia, con el límite por minuto de tu plan, así que consultarlos periódicamente nunca ralentiza tus decisiones. Las lecturas no se facturan.
Listar y obtener decisiones
GET /v1/decisions y GET /v1/decisions/{slug} — las decisiones del workspace de una clave de API y el contrato de la versión activa de cada una — más la delegación de GPT-Live de una decisión y su endpoint de respuestas.
Listar ejecuciones
GET /v1/executions — ejecuciones recientes de tus decisiones con respuestas, acción, motivo y métricas, filtradas por decisión y estado y paginadas con un cursor. Las entradas nunca se devuelven.