Guía de referencia de la API de administración de Claude Enterprise

Esta guía cubre límites de gasto y solicitudes de aumento de límite de gasto para su organización de Claude Enterprise usando la API de administración de Claude Enterprise. Los límites de gasto le permiten limitar el gasto de créditos de uso de cada miembro durante un período recurrente, ver de dónde se hereda el límite de cada miembro y revisar o actuar sobre las solicitudes de los miembros para un límite más alto.

Para informes de uso y costo por usuario y con depósitos de tiempo, consulte la guía de referencia de la API de análisis de Claude Enterprise.

La API de administración de Claude Enterprise está actualmente en versión beta pública y disponible para organizaciones en planes Enterprise con créditos de uso habilitados.

Descripción general

Hay ocho puntos finales en dos recursos:

Recurso	Puntos finales	Usar para
Límites de gasto	`GET /v1/organizations/spend_limits/effective` `GET /v1/organizations/spend_limits/{spend_limit_id}` `POST /v1/organizations/spend_limits` `DELETE /v1/organizations/spend_limits/{spend_limit_id}`	Leer el límite efectivo de cada miembro y el gasto acumulado en el período; establecer o borrar una anulación por usuario.
Solicitudes de aumento de límite de gasto	`GET /v1/organizations/spend_limit_increase_requests` `GET /v1/organizations/spend_limit_increase_requests/{id}` `POST /v1/organizations/spend_limit_increase_requests/{id}/approve` `POST /v1/organizations/spend_limit_increase_requests/{id}/deny`	Enumerar las solicitudes de los miembros para un límite más alto, con el contexto necesario para decidir; aprobar o rechazar cada solicitud.

Use los puntos finales de límites de gasto para responder: "¿Qué límite se aplica a cada miembro, de dónde viene y qué tan cerca están?" y para establecer una anulación por usuario. Use los puntos finales de solicitudes de aumento de límite de gasto para procesar la cola de solicitudes enviadas por miembros.

Requisitos previos y autenticación

Su organización debe estar en un plan de Claude Enterprise.
Los créditos de uso deben estar habilitados para su organización. Su propietario principal puede habilitarlos en Configuración de facturación en Claude.
El propietario principal necesita crear una clave de API de administración con uno o ambos de los siguientes alcances:
- read:spend_limits (requerido para todos los puntos finales GET)
- write:spend_limits (requerido para puntos finales POST y DELETE)

Pase la clave en el encabezado x-api-key en cada solicitud.

Importante: No comparta claves de API públicamente ni las registre en el control de código fuente.

URL base

https://api.anthropic.com

Limitación de velocidad

Los ocho puntos finales comparten un único límite por organización de 60 solicitudes por minuto. Las solicitudes que superan el límite devuelven 429 Demasiadas solicitudes.

Paginación

GET /v1/organizations/spend_limits/effective y GET /v1/organizations/spend_limit_increase_requests se paginan con un cursor opaco. La primera solicitud devuelve hasta limit filas más un cursor next_page. Pase ese cursor sin cambios como el parámetro page en la siguiente solicitud y repita hasta que next_page sea null.

Importante: No cambie los parámetros de consulta en medio de la secuencia. Los cursores están vinculados a los filtros que los emitieron. Si cambia user_ids[], status[] o actor_ids[] y pasa un cursor antiguo, obtendrá un 400 con "cursor does not match current query parameters". En su lugar, inicie una nueva secuencia desde la primera página.

Trate la cadena del cursor como opaca: no la analice, modifique ni la construya usted mismo.

Serialización de parámetros de lista

Los parámetros de lista utilizan notación de corchetes: repita el nombre del parámetro con [] para cada valor.

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq

Respuestas de error

Estado	Significado
400	Entrada inválida, valor de parámetro no compatible, cursor de página no coincide con los parámetros actuales, o no se cumple una precondición (consulte Validaciones por punto final).
401	Falta el encabezado `x-api-key`.
403	La clave de API no tiene el alcance requerido (`read:spend_limits` o `write:spend_limits`).
404	Recurso no encontrado, o la clave API es desconocida, ha expirado o ha sido revocada.
429	Límite de velocidad excedido.
500	Error interno.

Los cuerpos de error tienen la siguiente forma:

{"type": "error", "error": {"type": "<error_type>", "message": "..."}, "request_id": "req_..."}

error.type es un discriminador dependiente del estado: invalid_request_error (400), authentication_error (401), permission_error (403), not_found_error (404), rate_limit_error (429), api_error (500). request_id siempre está presente y es el valor a citar al contactar con soporte. La tabla de validaciones bajo cada endpoint enumera los mensajes específicos.

Conceptos

La jerarquía de límites de gasto

El gasto de crédito de uso de cada miembro está limitado por un límite de gasto efectivo, resuelto a partir de una jerarquía de niveles de alcance. Cuando un miembro no tiene una anulación por usuario, hereda el límite configurado para su nivel de asiento, su grupo (si su organización utiliza límites basados en grupos) o el valor predeterminado de toda la organización.

Leer GET /v1/organizations/spend_limits/effective devuelve cada miembro actual con su límite efectivo resuelto, de dónde se resolvió ese límite (source) y su gasto acumulado en el período. Establecer una anulación por usuario a través de POST /v1/organizations/spend_limits fija un miembro a un límite específico independientemente de lo que heredaría de otra manera. Eliminar la anulación los devuelve al límite heredado.

Alcance

Un alcance identifica el nivel en el que se escribe o resuelve un límite de gasto:

Tipo	Campos	Significado
`user`	`user_id`	Un miembro específico. `user_id` coincide con los IDs devueltos por los endpoints de usuarios de la API de administración.
`seat_tier`	`seat_tier`	Un valor predeterminado de nivel de asiento. Los valores de `seat_tier` son identificadores completamente calificados como `enterprise_standard` o `enterprise_tier_1`; se pueden agregar valores adicionales.
`rbac_group`	`rbac_group_id`	Un valor predeterminado de grupo, cuando su organización gestiona límites por grupo.
`organization`	—	El valor predeterminado de toda la organización.

scope.type es una cadena abierta. Los clientes deben tratar los valores desconocidos como opacos y continuar en lugar de fallar. Se pueden agregar tipos de alcance adicionales en el futuro.

Período

period es la ventana recurrente durante la cual se aplica el límite y se reinicia el gasto. El único valor hoy es "monthly".

period es una cadena abierta. Los clientes deben tratar los valores desconocidos como opacos y continuar en lugar de fallar. Se pueden agregar valores de período adicionales en el futuro.

Montos y moneda

Todos los valores monetarios son cadenas en unidades menores de la moneda de facturación de la organización (centavos, para USD). Por ejemplo, "50000" representa 500.00 USD. Analice como decimal y divida por 100 para mostrar dólares. Evite aritmética de punto flotante binario para valores grandes.

amount es anulable: null significa ilimitado (sin límite). "0" significa que los créditos de uso están deshabilitados para ese miembro.

period_to_date_spend es el crédito de uso acumulado del miembro desde el inicio del period actual, en el mismo formato de unidad menor. Puede incluir una parte fraccionaria (por ejemplo, "41280.125").

Ciclo de vida de la solicitud de aumento de límite de gasto

Una solicitud de aumento de límite de gasto se crea cuando un miembro hace clic en "solicitar más uso" en claude.ai. Las solicitudes no se crean a través de esta API.

Estado	Significado
`pending`	Esperando acción del administrador. La solicitud normalmente lleva un `spend_summary` activo para que pueda ver el límite efectivo actual del miembro y el gasto acumulado en el período mientras decide. `spend_summary` puede ser `null` si no se pudo calcular, así que maneje ese caso.
`approved`	La solicitud se resolvió con aprobación: ya sea que un administrador la aprobara explícitamente (escribiendo un límite de gasto por usuario en la cantidad proporcionada por el administrador), otra acción del administrador puso créditos de uso disponibles para el miembro (por ejemplo, aumentar un límite de nivel de asiento o habilitar facturación de créditos de uso para la organización), o el soporte de Anthropic aumentó un límite en nombre de la organización. `spend_summary` es `null`.
`denied`	Un administrador rechazó. `spend_summary` es `null`. Claude.ai oculta el botón de solicitud de ese miembro durante 30 días desde `resolved_at`; un administrador aún puede aumentar el límite del miembro directamente en cualquier momento.

Tanto approved como denied son terminales. Un miembro tiene como máximo una solicitud pending a la vez.

Aprobar a través de POST …/approve escribe la misma fila de límite de gasto por usuario que POST /v1/organizations/spend_limits escribe. Establecer un límite de gasto directamente no transiciona una solicitud pendiente. Use el endpoint de aprobación para resolver una solicitud.

De forma predeterminada, Anthropic envía un correo electrónico al miembro cuando su solicitud es aprobada o rechazada. Pase suppress_notification: true en aprobar o rechazar para suprimir ese correo electrónico (por ejemplo, cuando su propio sistema notifica al miembro).

El objeto SpendLimit

Un límite configurado en un nivel de alcance.

{
  "type": "spend_limit",
  "id": "spl_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-01T12:00:00Z",
  "updated_at": "2026-05-03T09:14:11Z",
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "50000",
  "currency": "USD",
  "period": "monthly"
}

Campo	Tipo	Descripción
`type`	cadena	Siempre `"spend_limit"`.
`id`	cadena	Con prefijo `spl_`.
`created_at`	cadena (RFC 3339)	Cuándo se estableció este límite por primera vez.
`updated_at`	cadena (RFC 3339)	Cuándo se cambió este límite por última vez.
`scope`	Alcance	El nivel en el que se escribe este límite. Consulte la sección "Alcance".
`amount`	cadena o nulo	Límite para el `period`, en unidades menores. `null` significa ilimitado.
`currency`	cadena	ISO 4217. La moneda de facturación de la organización.
`period`	cadena	La ventana recurrente durante la cual se aplica `amount`. Consulte la sección "Período".

El objeto SpendSummary

Una fila de informe calculada por miembro: el límite efectivo del miembro, de dónde proviene y su gasto acumulado en el período. No es un recurso direccionable (sin id).

{
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "50000",
  "currency": "USD",
  "period": "monthly",
  "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
  "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
  "period_to_date_spend": "31402.5"
}

Campo	Tipo	Descripción
`scope`	Alcance (`type: "user"`)	El miembro para el que es esta fila.
`amount`	cadena o nulo	El límite efectivo para el `period`, en unidades menores. `null` significa ilimitado; `"0"` significa que los créditos de uso están deshabilitados.
`currency`	cadena	ISO 4217.
`period`	El período del límite de gasto que `source` resolvió. Consulte la sección "Período".	The period of the spend limit that `source` resolved to. See the "Period" section.
`source`	Alcance	De dónde se resolvió `amount` en la jerarquía. Es igual a `scope` cuando el miembro tiene una anulación por usuario.
`spend_limit_id`	cadena	ID del `SpendLimit` al que se resolvió `source`. Obtenerlo con `GET /v1/organizations/spend_limits/{spend_limit_id}`.
`period_to_date_spend`	cadena	Créditos de uso acumulados del miembro desde el inicio del `period` actual, en unidades menores.

El objeto SpendLimitIncreaseRequest

{
  "type": "spend_limit_increase_request",
  "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-04T16:22:09Z",
  "status": "pending",
  "resolved_at": null,
  "resolved_by": null,
  "actor": {
    "type": "user_actor",
    "user_id": "user_01AbCdEfGh",
    "name": "Jane Smith",
    "email_address": "[email protected]"
  },
  "spend_summary": {
    "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
    "amount": "50000",
    "currency": "USD",
    "period": "monthly",
    "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
    "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
    "period_to_date_spend": "48900"
  }
}

Campo	Tipo	Descripción
`type`	cadena	Siempre `"spend_limit_increase_request"`.
`id`	cadena	Con prefijo `slir_`.
`created_at`	cadena (RFC 3339)	Cuándo el miembro envió la solicitud.
`status`	cadena	`pending`, `approved`, o `denied`.
`resolved_at`	cadena (RFC 3339) o nulo	Cuándo se aprobó o rechazó la solicitud. `null` mientras está pendiente.
`resolved_by`	Actor o nulo	Quién aprobó o rechazó la solicitud: ya sea un `user_actor` (un administrador actuó en claude.ai) o un `scoped_api_key_actor` (resuelto a través de esta API). Cuando una solicitud se resuelve automáticamente por una acción de administrador en claude.ai (por ejemplo, aumentar un límite de nivel de asiento, habilitar facturación de créditos de uso para la organización o aumentar el límite del miembro), `resolved_by` es el `user_actor` del administrador actuante. `null` mientras está pendiente, cuando la cuenta del administrador que resuelve ha sido eliminada, o cuando la solicitud fue resuelta por el soporte de Anthropic. Un `scoped_api_key_actor` puede hacer referencia a una clave que ha sido eliminada o revocada. Trate `scoped_api_key_id` como una referencia histórica y tolere fallos de búsqueda.
`actor`	Actor (`user_actor`)	El miembro que envió la solicitud.
`spend_summary`	SpendSummary o nulo	Contexto de decisión en vivo para el solicitante: su límite efectivo y gasto de período a la fecha. Presente mientras `status` está pendiente (puede ser `null` si el resumen no se pudo calcular); siempre `null` una vez resuelto.

Actor

Campo	Tipo	Descripción
`type`	cadena	`user_actor` o `scoped_api_key_actor`.
`user_id`	cadena	Presente en `user_actor`. El ID del usuario; mismo valor aceptado por `actor_ids[]`.
`name`	cadena o nulo	Presente en `user_actor`. El nombre del usuario; `null` si la cuenta ha sido eliminada o el usuario no ha establecido un nombre.
`email_address`	cadena o nulo	Presente en `user_actor`. El correo electrónico del usuario; `null` si la cuenta ha sido eliminada.
`scoped_api_key_id`	cadena	Presente en `scoped_api_key_actor`. Con prefijo `apikey_`.

Límites de gasto

1. Listar límites de gasto efectivos

GET /v1/organizations/spend_limits/effective

Devuelve todos los miembros actuales de la organización con su límite efectivo resuelto y gasto acumulado en el período. Los miembros sin anulación por usuario aparecen con source.type de seat_tier, rbac_group, u organization. Los miembros anteriores no se enumeran.

Requiere alcance: read:spend_limits.

Parámetros de consulta

Campo	Tipo	Requerido	Predeterminado	Descripción
`user_ids[]`	cadena, máximo 100 entradas	No	todos los miembros	Limitar a miembros específicos. Acepta IDs `user_...`. Una entrada que no sea miembro actual se omite silenciosamente de `data`.
`limit`	entero 1–1000	No	20	Filas por página.
`page`	cadena de cursor opaca	No	—	El valor `next_page` de una respuesta anterior.

Campos de respuesta

Campo	Tipo	Descripción
`data`	matriz de SpendSummary	Una entrada por miembro, ordenada por cuándo se unió el miembro a la organización (más reciente primero).
`next_page`	cadena o nulo	Cursor opaco para la siguiente página; `null` cuando no hay más páginas.

Solicitud de ejemplo

curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Respuesta de ejemplo

{
  "data": [
    {
      "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
      "amount": "50000",
      "currency": "USD",
      "period": "monthly",
      "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
      "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
      "period_to_date_spend": "31402.5"
    }
  ],
  "next_page": "page_..."
}

Validaciones

Condición	Estado	Mensaje
Entrada `user_ids[]` mal formada	400	`user_ids[]: la entrada no es un ID de usuario válido`
`user_ids[]` tiene más de 100 entradas	400
`limit` fuera del rango 1–1000	400
Cursor `page` inválido	400	`page: cursor inválido`
`page` cursor no coincide con `user_ids[]` actual	400	`page: cursor no coincide con los parámetros de consulta actuales`
`page` cursor de una versión de API diferente	400	`page: cursor fue emitido por una versión de API diferente`
La organización no está en un plan Enterprise	400	`este endpoint no es compatible con este tipo de organización`
Facturación de créditos de uso no habilitada	400	`la facturación por exceso no está habilitada para esta organización`

2. Obtener un límite de gasto

GET /v1/organizations/spend_limits/{spend_limit_id}

Devuelve un único límite de gasto por ID. Úsalo para inspeccionar la fila a la que hace referencia SpendSummary.spend_limit_id o una respuesta POST.

Requiere alcance: read:spend_limits.

Parámetros de ruta

Campo	Tipo	Descripción
`spend_limit_id`	cadena	Con prefijo `spl_`.

Respuesta

Un objeto SpendLimit.

Solicitud de ejemplo

curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Validaciones

Condición	Estado	Mensaje
`spend_limit_id` no encontrado en esta organización	404
La organización no está en un plan Enterprise	400	`este endpoint no es compatible con este tipo de organización`
Facturación de créditos de uso no habilitada	400	`la facturación por exceso no está habilitada para esta organización`

3. Establecer un límite de gasto

POST /v1/organizations/spend_limits

Establece un anulación de límite de gasto por usuario. Upsert: establecer un límite para un usuario que ya tiene uno lo sobrescribe en su lugar.

Solo se acepta scope.type: "user". Los valores predeterminados de nivel de asiento, grupo y organización se configuran en la configuración de claude.ai.

Establecer un límite de gasto directamente no transiciona la solicitud de aumento pendiente de un miembro. Usa el endpoint de aprobación para resolver una solicitud.

Requiere alcance: write:spend_limits.

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`scope`	objeto	Sí	`{ "type": "user", "user_id": "user_..." }`.
`amount`	cadena o nulo	Sí	Nuevo límite para el `period`, en unidades menores, como una cadena decimal entera no negativa. `"0"` desactiva el crédito de uso para el miembro. `null` elimina el límite (ilimitado).
`period`	cadena	No	Por defecto `"monthly"`. Consulte la sección "Period".

Respuesta

Un objeto SpendLimit que refleja la anulación escrita.

Solicitud de ejemplo

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limits" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "75000"}'

Respuesta de ejemplo

{
  "type": "spend_limit",
  "id": "spl_01RsTuVwXyZaBcDeFgHiJk",
  "created_at": "2026-05-11T10:02:44Z",
  "updated_at": "2026-05-11T10:02:44Z",
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "75000",
  "currency": "USD",
  "period": "monthly"
}

Validaciones

Condición	Estado	Mensaje
`scope.type` no es `"user"`	400	`scope.type: aún no compatible`
`scope.user_id` malformado	400	`scope.user_id: malformado`
`scope.user_id` no es miembro de esta organización	400	`scope.user_id: no es miembro de esta organización`
`amount` negativo, fraccionario o no es una cadena decimal válida	400
`period` no es `"monthly"`	400	`period: aún no compatible`
La organización no está en un plan Enterprise	400	`este endpoint no es compatible para este tipo de organización`
Facturación de crédito de uso no habilitada	400	`la facturación de excedentes no está habilitada para esta organización`

4. Eliminar un límite de gasto

DELETE /v1/organizations/spend_limits/{spend_limit_id}

Elimina una anulación por usuario para que el miembro vuelva al límite heredado (nivel de asiento, grupo o predeterminado de la organización). Las filas de nivel de asiento, grupo y organización no se pueden eliminar a través de este endpoint.

Requiere alcance: write:spend_limits.

Parámetros de ruta

Campo	Tipo	Descripción
`spend_limit_id`	cadena	Con prefijo `spl_`. Debe ser el ID de una anulación por usuario.

Respuesta

{ "type": "spend_limit_deleted", "id": "spl_01RsTuVwXyZaBcDeFgHiJk" }

Solicitud de ejemplo

curl -X DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Validaciones

Condición	Estado	Mensaje
`spend_limit_id` no encontrado en esta organización	404
`spend_limit_id` es una fila de nivel de asiento, grupo u organización	400	`Solo los límites de gasto por usuario pueden eliminarse a través de este endpoint.`
La organización no está en un plan Enterprise	400	`este endpoint no es compatible con este tipo de organización`
Facturación de crédito de uso no habilitada	400	`la facturación de excedentes no está habilitada para esta organización`

Solicitudes de aumento de límite de gasto

5. Listar solicitudes de aumento

GET /v1/organizations/spend_limit_increase_requests

Lista las solicitudes de aumento, las más recientes primero. Se excluyen las solicitudes cuyo solicitante ya no es miembro de la organización.

Requiere alcance: read:spend_limits.

Parámetros de consulta

Campo	Tipo	Requerido	Predeterminado	Descripción
`status[]`	uno o más de `pending`, `approved`, `denied`	No	todos	Filtrar por estado. Repite el parámetro para múltiples valores.
`actor_ids[]`	cadena	No	todos	Filtrar por solicitante. Acepta IDs `user_...`.
`limit`	entero 1–1000	No	20	Filas por página.
`page`	cadena de cursor opaca	No	—	El valor `next_page` de una respuesta anterior.

Campos de respuesta

Campo	Tipo	Descripción
`datos`	matriz de SpendLimitIncreaseRequest	Ordenado por `created_at` descendente.
`next_page`	cadena o nulo	Cursor opaco para la siguiente página; `null` cuando no hay más páginas.

Solicitud de ejemplo

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Respuesta de ejemplo

{
  "data": [
    {
      "type": "spend_limit_increase_request",
      "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
      "created_at": "2026-05-04T16:22:09Z",
      "status": "pending",
      "resolved_at": null,
      "resolved_by": null,
      "actor": {
        "type": "user_actor",
        "user_id": "user_01AbCdEfGh",
        "name": "Jane Smith",
        "email_address": "[email protected]"
      },
      "spend_summary": {
        "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
        "amount": "50000",
        "currency": "USD",
        "period": "monthly",
        "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
        "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
        "period_to_date_spend": "48900"
      }
    }
  ],
  "next_page": null
}

Validaciones

Condición	Estado	Mensaje
`actor_ids[]` entrada malformada	400	`actor_ids[]: ID de usuario etiquetado inválido`
`limit` fuera de 1–1000	400
`page` cursor malformado	400	`formato de cursor de página inválido` o `cursor de página inválido`
`page` cursor no coincide con `status[]` o `actor_ids[]` actual	400	`el cursor de página no coincide con los parámetros de consulta actuales`
`page` cursor de una versión de API diferente	400	`el cursor de página fue emitido por una versión de API diferente; reinicie la paginación`
La organización no está en un plan Enterprise	400	`este endpoint no es compatible con este tipo de organización`
Facturación de créditos de uso no habilitada	400	`la facturación de excedentes no está habilitada para esta organización`

6. Obtener una solicitud de aumento

GET /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Devuelve una única solicitud de aumento.

Requiere alcance: read:spend_limits.

Parámetros de ruta

Campo	Tipo	Descripción
`spend_limit_increase_request_id`	cadena	Con prefijo `slir_`.

Respuesta

Un objeto SpendLimitIncreaseRequest.

Solicitud de ejemplo

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Validaciones

Condición	Estado	Mensaje
Solicitud no encontrada en esta organización	404
El solicitante ya no es miembro de esta organización	404
La organización no tiene un plan Enterprise	400	`este endpoint no es compatible con este tipo de organización`
Facturación de créditos de uso no habilitada	400	`la facturación de excedentes no está habilitada para esta organización`

7. Aprobar una solicitud de aumento

POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Aprueba una solicitud pendiente. Escribe un límite de gasto por usuario en amount para el solicitante y transiciona la solicitud a approved. Si la solicitud no lleva un monto solicitado, el administrador proporciona el nuevo límite al aprobar.

Requiere alcance: write:spend_limits.

Parámetros de ruta

Campo	Tipo	Descripción
`spend_limit_increase_request_id`	cadena	Con prefijo `slir_`.

Cuerpo de la solicitud

Campo	Tipo	Requerido	Predeterminado	Descripción
`amount`	cadena	Sí	—	Nuevo límite por usuario para el `period`, en unidades menores, como una cadena decimal de entero no negativo.
`period`	cadena	No	`"monthly"`	Consulta la sección "Period".
`suppress_notification`	booleano	No	`false`	Si `true`, Anthropic no envía un correo electrónico al miembro notificando que su solicitud fue aprobada.

Respuesta

El SpendLimitIncreaseRequest en estado approved, con un campo adicional spend_limit que contiene el SpendLimit que fue escrito.

Solicitud de ejemplo

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"amount": "75000", "suppress_notification": true}'

Respuesta de ejemplo

{
  "type": "spend_limit_increase_request",
  "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-04T16:22:09Z",
  "status": "approved",
  "resolved_at": "2026-05-11T10:05:02Z",
  "resolved_by": {
    "type": "scoped_api_key_actor",
    "scoped_api_key_id": "apikey_01ZyXwVuTsRqPoNmLkJiHg"
  },
  "actor": {
    "type": "user_actor",
    "user_id": "user_01AbCdEfGh",
    "name": "Jane Smith",
    "email_address": "[email protected]"
  },
  "spend_summary": null,
  "spend_limit": {
    "type": "spend_limit",
    "id": "spl_01RsTuVwXyZaBcDeFgHiJk",
    "created_at": "2026-05-11T10:05:02Z",
    "updated_at": "2026-05-11T10:05:02Z",
    "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
    "amount": "75000",
    "currency": "USD",
    "period": "monthly"
  }
}

Validaciones

Condición	Estado	Mensaje
Solicitud no encontrada en esta organización	404
El solicitante ya no es miembro de esta organización	404
Solicitud ya `aprobada` o `denegada`	400	`la solicitud de aumento de límite de gasto ya está resuelta`
`cantidad` negativa, fraccionaria o no es una cadena decimal válida	400
`período` no es `"mensual"`	400	`período: aún no compatible`
La organización no está en un plan Enterprise	400	`este endpoint no es compatible para este tipo de organización`
Facturación de crédito de uso no habilitada	400	`la facturación de excedentes no está habilitada para esta organización`

8. Denegar una solicitud de aumento

POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

Deniega una solicitud pendiente. Idempotente en denegada: denegar una solicitud ya denegada devuelve 200 con el recurso existente. Denegar una solicitud ya aprobada se rechaza para que la automatización pueda distinguir un reintento de una decisión conflictiva.

Requiere alcance: write:spend_limits.

Parámetros de ruta

Campo	Tipo	Descripción
`spend_limit_increase_request_id`	cadena	Con prefijo `slir_`.

Cuerpo de la solicitud

Campo	Tipo	Requerido	Predeterminado	Descripción
`suprimir_notificación`	booleano	No	`falso`	Si `verdadero`, Anthropic no envía un correo electrónico al miembro notificándole que su solicitud fue denegada.

Respuesta

Una SpendLimitIncreaseRequest con estado denegado.

Solicitud de ejemplo

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"suppress_notification": true}'

Validaciones

Condición	Estado	Mensaje
Solicitud no encontrada en esta organización	404
El solicitante ya no es miembro de esta organización	404
Solicitud ya `aprobada`	400	`la solicitud de aumento de límite de gasto ya está aprobada`
Solicitud ya `denegada`	— (200, idempotent)
La organización no está en un plan Enterprise	400	`este endpoint no es compatible con este tipo de organización`
Créditos de uso no habilitados	400	`la facturación por exceso no está habilitada para esta organización`