Guia de referência da API de administração do Claude Enterprise

Este guia aborda limites de gastos e solicitações de aumento de limite de gastos para sua organização Claude Enterprise usando a API de administração do Claude Enterprise. Os limites de gastos permitem que você limite o gasto de créditos de uso de cada membro durante um período recorrente, veja de onde o limite de cada membro é herdado e revise ou atue nas solicitações dos membros para um limite mais alto.

Para relatórios de uso e custo por usuário e com intervalo de tempo, consulte o guia de referência da API de análise do Claude Enterprise.

A API de administração do Claude Enterprise está atualmente em beta público e disponível para organizações em planos Enterprise com créditos de uso ativados.

Visão geral

Existem oito endpoints em dois recursos:

Recurso	Endpoints	Usar para
Limites de gastos	`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}`	Leia o limite efetivo de cada membro e o gasto acumulado no período; defina ou limpe uma substituição por usuário.
Solicitações de aumento de limite de gastos	`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`	Liste as solicitações dos membros para um limite mais alto, com o contexto necessário para decidir; aprove ou negue cada solicitação.

Use os endpoints de limites de gastos para responder: "Qual limite se aplica a cada membro, de onde vem e quão perto estão dele?" e para definir uma substituição por usuário. Use os endpoints de solicitações de aumento de limite de gastos para trabalhar a fila de solicitações enviadas pelos membros.

Pré-requisitos e autenticação

Sua organização deve estar em um plano Claude Enterprise.
Os créditos de uso devem estar ativados para sua organização. Seu Proprietário Primário pode ativar isso em Configurações de faturamento no Claude.
O Proprietário Primário precisa gerar uma chave de API de administração com um ou ambos os seguintes escopos:
- read:spend_limits (obrigatório para todos os endpoints GET)
- write:spend_limits (obrigatório para endpoints POST e DELETE)

Passe a chave no cabeçalho x-api-key em cada solicitação.

Importante: Não compartilhe chaves de API publicamente ou as verifique no controle de origem.

URL base

https://api.anthropic.com

Limitação de taxa

Todos os oito endpoints compartilham um único limite por organização de 60 solicitações por minuto. Solicitações acima do limite retornam 429 Too Many Requests.

Paginação

GET /v1/organizations/spend_limits/effective e GET /v1/organizations/spend_limit_increase_requests são paginados com um cursor opaco. A primeira solicitação retorna até limit linhas mais um cursor next_page. Passe esse cursor inalterado como o parâmetro page na próxima solicitação e repita até que next_page seja null.

Importante: Não altere os parâmetros de consulta no meio da sequência. Os cursores estão vinculados aos filtros que os emitiram. Se você alterar user_ids[], status[] ou actor_ids[] e passar um cursor antigo, você receberá um 400 com "cursor does not match current query parameters". Inicie uma nova sequência a partir da primeira página.

Trate a string do cursor como opaca: não analise, modifique ou construa você mesmo.

Serializando parâmetros de lista

Os parâmetros de lista usam notação de colchetes: repita o nome do parâmetro com [] para cada valor.

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq

Respostas de erro

Status	Significado
400	Entrada inválida, valor de parâmetro não suportado, cursor de página não corresponde aos parâmetros atuais ou uma pré-condição não é atendida (consulte Validações por endpoint).
401	Cabeçalho `x-api-key` ausente.
403	A chave de API não possui o escopo necessário (`read:spend_limits` ou `write:spend_limits`).
404	Recurso não encontrado, ou a chave de API é desconhecida, expirada ou revogada.
429	Limite de taxa excedido.
500	Erro interno.

Os corpos de erro têm a seguinte forma:

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

error.type é um discriminador dependente do status: invalid_request_error (400), authentication_error (401), permission_error (403), not_found_error (404), rate_limit_error (429), api_error (500). request_id está sempre presente e é o valor a citar ao contactar o suporte. A tabela de Validações em cada endpoint lista as mensagens específicas.

Conceitos

A hierarquia de limite de gastos

O gasto de crédito de uso de cada membro é limitado por um limite de gasto efetivo, resolvido a partir de uma hierarquia de níveis de escopo. Quando um membro não tem uma substituição por usuário, herda o limite configurado para seu nível de assento, seu grupo (se sua organização usa limites baseados em grupo) ou o padrão em toda a organização.

Ler GET /v1/organizations/spend_limits/effective retorna cada membro atual com seu limite efetivo resolvido, de onde esse limite foi resolvido (source) e seu gasto até a data do período. Definir uma substituição por usuário via POST /v1/organizations/spend_limits fixa um membro a um limite específico, independentemente do que ele herdaria. Excluir a substituição o retorna ao limite herdado.

Escopo

Um escopo identifica o nível em que um limite de gasto é escrito ou resolvido:

Tipo	Campos	Significado
`user`	`user_id`	Um membro específico. `user_id` corresponde aos IDs retornados pelos endpoints de usuários da API de administração.
`seat_tier`	`seat_tier`	Um padrão de nível de assento. Os valores de `seat_tier` são identificadores totalmente qualificados, como `enterprise_standard` ou `enterprise_tier_1`; valores adicionais podem ser adicionados.
`rbac_group`	`rbac_group_id`	Um padrão de grupo, quando sua organização gerencia limites por grupo.
`organization`	—	O padrão em toda a organização.

scope.type é uma string aberta. Os clientes devem tratar valores desconhecidos como opacos e passar por eles em vez de falhar. Tipos de escopo adicionais podem ser adicionados no futuro.

Período

period é a janela recorrente sobre a qual o limite é aplicado e o gasto é redefinido. O único valor hoje é "monthly".

period é uma string aberta. Os clientes devem tratar valores desconhecidos como opacos e passar por eles em vez de falhar. Valores de período adicionais podem ser adicionados no futuro.

Valores e moeda

Todos os valores monetários são strings em unidades menores da moeda de faturamento da organização (centavos, para USD). Por exemplo, "50000" representa 500,00 USD. Analise como decimal e divida por 100 para exibir dólares. Evite ponto flutuante binário para valores grandes.

amount é anulável: null significa ilimitado (sem limite). "0" significa que os créditos de uso estão desabilitados para esse membro.

period_to_date_spend é o crédito de uso acumulado do membro desde o início do period atual, no mesmo formato de unidade menor. Pode incluir uma parte fracionária (por exemplo, "41280.125").

Ciclo de vida da solicitação de aumento de limite de gastos

Uma solicitação de aumento de limite de gastos é criada quando um membro clica em "solicitar mais uso" em claude.ai. As solicitações não são criadas por meio desta API.

Status	Significado
`pending`	Aguardando ação do administrador. A solicitação normalmente carrega um `spend_summary` ativo para que você possa ver o limite efetivo atual do membro e o gasto até a data do período ao decidir. `spend_summary` pode ser `null` se não puder ser calculado, então trate esse caso.
`approved`	A solicitação foi resolvida com aprovação: um administrador a aprovou explicitamente (escrevendo um limite de gasto por usuário no valor fornecido pelo administrador), outra ação do administrador disponibilizou créditos de uso para o membro (por exemplo, aumentando um limite de nível de assento ou habilitando faturamento de crédito de uso para a organização) ou o suporte da Anthropic aumentou um limite em nome da organização. `spend_summary` é `null`.
`denied`	Um administrador recusou. `spend_summary` é `null`. Claude.ai oculta o botão de solicitação desse membro por 30 dias a partir de `resolved_at`; um administrador ainda pode aumentar o limite do membro diretamente a qualquer momento.

Tanto approved quanto denied são terminais. Um membro tem no máximo uma solicitação pending por vez.

Aprovar via POST …/approve escreve a mesma linha de limite de gasto por usuário que POST /v1/organizations/spend_limits escreve. Definir um limite de gasto diretamente não faz a transição de uma solicitação pendente. Use o endpoint de aprovação para resolver uma solicitação.

Por padrão, a Anthropic envia um e-mail ao membro quando sua solicitação é aprovada ou recusada. Passe suppress_notification: true em aprovar ou recusar para suprimir esse e-mail (por exemplo, quando seu próprio sistema notifica o membro).

O objeto SpendLimit

Um limite configurado em um nível de escopo.

{
  "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	Descrição
`type`	string	Sempre `"spend_limit"`.
`id`	string	Prefixado com `spl_`.
`created_at`	string (RFC 3339)	Quando este limite foi definido pela primeira vez.
`updated_at`	string (RFC 3339)	Quando este limite foi alterado pela última vez.
`scope`	Escopo	O nível em que este limite é definido. Consulte a seção "Escopo".
`amount`	string ou null	Limite para o `period`, em unidades menores. `null` significa ilimitado.
`currency`	string	ISO 4217. A moeda de faturamento da organização.
`period`	string	A janela recorrente sobre a qual `amount` é aplicado. Consulte a seção "Período".

O objeto SpendSummary

Uma linha de relatório calculada por membro: o limite efetivo do membro, sua origem e o gasto acumulado no período. Não é um recurso endereçável (sem 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	Descrição
`scope`	Escopo (`type: "user"`)	O membro para o qual esta linha é.
`amount`	string ou null	O limite efetivo para o `period`, em unidades menores. `null` significa ilimitado; `"0"` significa que os créditos de uso estão desabilitados.
`currency`	string	ISO 4217.
`period`	string	O período do limite de gasto que `source` foi resolvido. Consulte a seção "Período".
`source`	Escopo	De onde `amount` foi resolvido na hierarquia. Igual a `scope` quando o membro tem uma substituição por usuário.
`spend_limit_id`	string	ID do `SpendLimit` para o qual `source` foi resolvido. Busque-o com `GET /v1/organizations/spend_limits/{spend_limit_id}`.
`period_to_date_spend`	string	Créditos de uso acumulados pelo membro desde o início do `period` atual, em unidades menores.

O 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	Descrição
`type`	string	Sempre `"spend_limit_increase_request"`.
`id`	string	Prefixado com `slir_`.
`created_at`	string (RFC 3339)	Quando o membro enviou a solicitação.
`status`	string	`pending`, `approved` ou `denied`.
`resolved_at`	string (RFC 3339) ou null	Quando a solicitação foi aprovada ou negada. `null` enquanto pendente.
`resolved_by`	Actor ou null	Quem aprovou ou negou a solicitação: um `user_actor` (um administrador agiu em claude.ai) ou um `scoped_api_key_actor` (resolvido por meio desta API). Quando uma solicitação é resolvida automaticamente por uma ação de administrador em claude.ai (por exemplo, aumentar um limite de nível de assento, ativar faturamento de crédito de uso para a organização ou aumentar o limite do membro), `resolved_by` é o `user_actor` do administrador atuante. `null` enquanto pendente, quando a conta do administrador resolvente foi excluída ou quando a solicitação foi resolvida pelo suporte da Anthropic. Um `scoped_api_key_actor` pode fazer referência a uma chave que foi excluída ou revogada. Trate `scoped_api_key_id` como uma referência histórica e tolere falhas de pesquisa.
`actor`	Actor (`user_actor`)	O membro que enviou a solicitação.
`spend_summary`	SpendSummary ou null	Contexto de decisão ao vivo para o solicitante: seu limite efetivo e gasto período-até-data. Presente enquanto `status` está pendente (pode ser `null` se o resumo não puder ser calculado); sempre `null` após resolvido.

Actor

Campo	Tipo	Descrição
`type`	string	`user_actor` ou `scoped_api_key_actor`.
`user_id`	string	Presente em `user_actor`. O ID do usuário; mesmo valor aceito por `actor_ids[]`.
`name`	string ou null	Presente em `user_actor`. O nome do usuário; `null` se a conta foi excluída ou o usuário não definiu um nome.
`email_address`	string ou null	Presente em `user_actor`. O email do usuário; `null` se a conta foi excluída.
`scoped_api_key_id`	string	Presente em `scoped_api_key_actor`. Prefixado com `apikey_`.

Limites de gastos

1. Listar limites de gastos efetivos

GET /v1/organizations/spend_limits/effective

Retorna todos os membros atuais da organização com seu limite efetivo resolvido e gastos acumulados no período. Membros sem substituição por usuário aparecem com source.type de seat_tier, rbac_group ou organization. Ex-membros não são listados.

Requer escopo: read:spend_limits.

Parâmetros de consulta

Campo	Tipo	Obrigatório	Padrão	Descrição
`user_ids[]`	string, máx. 100 entradas	Não	todos os membros	Restringir a membros específicos. Aceita IDs `user_...`. Uma entrada que não é um membro atual é silenciosamente omitida de `data`.
`limit`	inteiro 1–1000	Não	20	Linhas por página.
`page`	string de cursor opaco	Não	—	O valor `next_page` de uma resposta anterior.

Campos de resposta

Campo	Tipo	Descrição
`data`	array de SpendSummary	Uma entrada por membro, ordenada por quando o membro se juntou à organização (mais recente primeiro).
`next_page`	string ou null	Cursor opaco para a próxima página; `null` quando não há mais páginas.

Exemplo de solicitação

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

Exemplo de resposta

{
  "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_..."
}

Validações

Condição	Status	Mensagem
entrada `user_ids[]` malformada	400	`user_ids[]: entry is not a valid user ID`
`user_ids[]` tem mais de 100 entradas	400
`limit` fora do intervalo 1–1000	400
cursor `page` inválido	400	`página: cursor inválido`
`página` cursor não corresponde ao `user_ids[]` atual	400	`página: cursor não corresponde aos parâmetros de consulta atuais`
`página` cursor de uma versão de API diferente	400	`página: cursor foi emitido por uma versão de API diferente`
A organização não está em um plano Enterprise	400	`este endpoint não é suportado para este tipo de organização`
Faturamento de crédito de uso não ativado	400	`faturamento de excedente não está ativado para esta organização`

2. Obter um limite de gastos

GET /v1/organizations/spend_limits/{spend_limit_id}

Retorna um único limite de gastos por ID. Use isto para inspecionar a linha que um SpendSummary.spend_limit_id ou uma resposta POST referenciou.

Requer escopo: read:spend_limits.

Parâmetros de caminho

Campo	Tipo	Descrição
`spend_limit_id`	string	Prefixado com `spl_`.

Resposta

Um objeto SpendLimit.

Exemplo de solicitação

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

Validações

Condição	Status	Mensagem
`spend_limit_id` não encontrado nesta organização	404
A organização não está em um plano Enterprise	400	`este endpoint não é suportado para este tipo de organização`
Faturamento de crédito de uso não ativado	400	`faturamento de excedente não está ativado para esta organização`

3. Definir um limite de gastos

POST /v1/organizations/spend_limits

Define uma substituição de limite de gastos por usuário. Upsert: definir um limite para um usuário que já possui um o sobrescreve no local.

Apenas scope.type: "user" é aceito. Os padrões de nível de assento, grupo e organização são configurados nas configurações do claude.ai.

Definir um limite de gastos diretamente não faz a transição da solicitação de aumento pendente de um membro. Use o endpoint de aprovação para resolver uma solicitação.

Requer escopo: write:spend_limits.

Corpo da solicitação

Campo	Tipo	Obrigatório	Descrição
`scope`	objeto	Sim	`{ "type": "user", "user_id": "user_..." }`.
`amount`	string ou null	Sim	Novo limite para o `period`, em unidades menores, como uma string decimal inteira não-negativa. `"0"` desativa o crédito de uso para o membro. `null` remove o limite (ilimitado).
`period`	string	Não	Padrão `"monthly"`. Consulte a seção "Period".

Resposta

Um objeto SpendLimit refletindo a substituição escrita.

Exemplo de solicitação

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"}'

Exemplo de resposta

{
  "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"
}

Validações

Condição	Status	Mensagem
`scope.type` não é `"user"`	400	`scope.type: ainda não suportado`
`scope.user_id` malformado	400	`scope.user_id: malformado`
`scope.user_id` não é um membro desta organização	400	`scope.user_id: não é um membro desta organização`
`amount` negativo, fracionário ou não é uma string decimal válida	400
`period` não é `"monthly"`	400	`period: ainda não suportado`
A organização não está em um plano Enterprise	400	`este endpoint não é suportado para este tipo de organização`
Faturamento de crédito de uso não ativado	400	`faturamento de excedente não está ativado para esta organização`

4. Remover um limite de gastos

DELETE /v1/organizations/spend_limits/{spend_limit_id}

Remove uma substituição por usuário para que o membro volte ao limite herdado (nível de assento, grupo ou padrão da organização). Linhas de nível de assento, grupo e organização não podem ser excluídas por este endpoint.

Requer escopo: write:spend_limits.

Parâmetros de caminho

Campo	Tipo	Descrição
`spend_limit_id`	string	Prefixado com `spl_`. Deve ser o ID de uma substituição por usuário.

Resposta

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

Solicitação de exemplo

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

Validações

Condição	Status	Mensagem
`spend_limit_id` não encontrado nesta organização	404
`spend_limit_id` é uma linha de nível de assento, grupo ou organização	400	`Apenas limites de gastos por usuário podem ser excluídos por este endpoint.`
A organização não está em um plano Enterprise	400	`este endpoint não é suportado para este tipo de organização`
Faturamento de crédito de uso não ativado	400	`o faturamento de excedente não está ativado para esta organização`

Solicitações de aumento de limite de gastos

5. Listar solicitações de aumento

GET /v1/organizations/spend_limit_increase_requests

Lista solicitações de aumento, as mais recentes primeiro. Solicitações cujo solicitante não é mais membro da organização são excluídas.

Requer escopo: read:spend_limits.

Parâmetros de consulta

Campo	Tipo	Obrigatório	Padrão	Descrição
`status[]`	um ou mais de `pending`, `approved`, `denied`	Não	todos	Filtrar por status. Repita o parâmetro para múltiplos valores.
`actor_ids[]`	string	Não	todos	Filtrar por solicitante. Aceita IDs `user_...`.
`limit`	inteiro 1–1000	Não	20	Linhas por página.
`page`	string de cursor opaco	Não	—	O valor `next_page` de uma resposta anterior.

Campos de resposta

Campo	Tipo	Descrição
`dados`	matriz de SpendLimitIncreaseRequest	Ordenado por `created_at` descendente.
`next_page`	string ou null	Cursor opaco para a próxima página; `null` quando não há mais páginas.

Exemplo de solicitação

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

Exemplo de resposta

{
  "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
}

Validações

Condição	Status	Mensagem
`actor_ids[]` entrada malformada	400	`actor_ids[]: ID de usuário marcado inválido`
`limit` fora de 1–1000	400
`page` cursor malformado	400	`formato de cursor de página inválido` ou `cursor de página inválido`
`page` cursor não corresponde ao `status[]` ou `actor_ids[]` atual	400	`cursor de página não corresponde aos parâmetros de consulta atuais`
`page` cursor de uma versão de API diferente	400	`cursor de página foi emitido por uma versão de API diferente; reinicie a paginação`
Organização não está em um plano Enterprise	400	`este endpoint não é suportado para este tipo de organização`
Faturamento de crédito de uso não habilitado	400	`faturamento de excedente não está habilitado para esta organização`

6. Obter uma solicitação de aumento

GET /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Retorna uma única solicitação de aumento.

Requer escopo: read:spend_limits.

Parâmetros de caminho

Campo	Tipo	Descrição
`spend_limit_increase_request_id`	string	Prefixado com `slir_`.

Resposta

Um objeto SpendLimitIncreaseRequest.

Exemplo de solicitação

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

Validações

Condição	Status	Mensagem
Solicitação não encontrada nesta organização	404
O solicitante não é mais membro desta organização	404
A organização não está em um plano Enterprise	400	`este endpoint não é suportado para este tipo de organização`
Faturamento de crédito de uso não habilitado	400	`o faturamento de excedente não está habilitado para esta organização`

7. Aprovar uma solicitação de aumento

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

Aprova uma solicitação pendente. Escreve um limite de gastos por usuário em amount para o solicitante e transiciona a solicitação para approved. A solicitação não carrega um valor solicitado, o administrador fornece o novo limite na aprovação.

Requer escopo: write:spend_limits.

Parâmetros de caminho

Campo	Tipo	Descrição
`spend_limit_increase_request_id`	string	Prefixado com `slir_`.

Corpo da solicitação

Campo	Tipo	Obrigatório	Padrão	Descrição
`amount`	string	Sim	—	Novo limite por usuário para o `period`, em unidades menores, como uma string decimal inteira não negativa.
`period`	string	Não	`"monthly"`	Veja a seção "Período".
`suppress_notification`	boolean	Não	`false`	Se `true`, a Anthropic não envia um email ao membro informando que sua solicitação foi aprovada.

Resposta

O SpendLimitIncreaseRequest com status approved, com um campo adicional spend_limit contendo o SpendLimit que foi escrito.

Exemplo de solicitação

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}'

Exemplo de resposta

{
  "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"
  }
}

Validações

Condição	Status	Mensagem
Solicitação não encontrada nesta organização	404
O solicitante não é mais membro desta organização	404
Solicitação já `aprovada` ou `negada`	400	`a solicitação de aumento de limite de gastos já foi resolvida`
`amount` negativo, fracionário ou não é uma string decimal válida	400
`period` não é `"monthly"`	400	`period: ainda não suportado`
A organização não está em um plano Enterprise	400	`este endpoint não é suportado para este tipo de organização`
Faturamento de crédito de uso não habilitado	400	`o faturamento de excedente não está habilitado para esta organização`

8. Negar uma solicitação de aumento

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

Nega uma solicitação pendente. Idempotente em denied: negar uma solicitação já negada retorna 200 com o recurso existente. Negar uma solicitação já aprovada é rejeitado para que a automação possa distinguir uma tentativa de uma decisão conflitante.

Requer escopo: write:spend_limits.

Parâmetros de caminho

Campo	Tipo	Descrição
`spend_limit_increase_request_id`	string	Prefixado com `slir_`.

Corpo da solicitação

Campo	Tipo	Obrigatório	Padrão	Descrição
`suppress_notification`	booleano	Não	`false`	Se `true`, a Anthropic não envia um email ao membro informando que sua solicitação foi negada.

Resposta

Uma SpendLimitIncreaseRequest com status negado.

Exemplo de solicitação

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}'

Validações

Condição	Status	Mensagem
Solicitação não encontrada nesta organização	404
O solicitante não é mais membro desta organização	404
Solicitação já `aprovada`	400	`solicitação de aumento de limite de gastos já foi aprovada`
Solicitação já `negada`	— (200, idempotent)
A organização não está em um plano Enterprise	400	`este endpoint não é suportado para este tipo de organização`
Créditos de uso não habilitados	400	`cobrança de excedente não está habilitada para esta organização`