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/me

Devuelve 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

200 OK
{
  "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"
  }
}
CampoTipoDescripción
workspace.idstringEl ID del workspace.
workspace.namestringEl nombre del workspace.
workspace.external_idstring | nullModo socio: con el header Dcision-Workspace, el external_id del subespacio; si no, null.
workspace.parentobject | nullCon el header Dcision-Workspace: { "id", "name" } de tu workspace, que paga el subespacio. plan y usage son entonces los tuyos.
workspace_usageobject | nullCon 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.idstringEl ID de la clave (key_…).
api_key.namestringEl nombre dado a la clave en API Keys.
api_key.prefixstringLa clave enmascarada, como se muestra en la app; nunca el secreto completo.
api_key.environmentstringlive o test.
plan.idstringgenesis, developer, growth o enterprise.
plan.namestringEl nombre visible del plan.
plan.rate_limit_per_minuteintegerSolicitudes por minuto permitidas para el workspace; consulta Rate limits.
plan.max_decisionsinteger o nullDecisiones que puede tener el workspace; null es ilimitado.
plan.log_retention_daysintegerCuánto tiempo conserva el plan las ejecuciones.
plan.hard_capbooleantrue 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.usedintegerDecisiones facturables en el período actual.
usage.includedintegerDecisiones incluidas en el período actual; en los planes anuales, la bolsa de todo el año.
usage.period_startstringInicio del período de facturación actual, ISO 8601.
usage.period_endstringFin 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

EstadoCódigoCuándo
401INVALID_API_KEYLa clave falta, está mal formada, es desconocida o fue revocada.
429RATE_LIMITEDDemasiadas 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.

En esta página