---
title: "Can Consume"
method: GET
path: "/organization/usage/can-consume/{resource_kind}"
tags: ["usage"]
---

# Can Consume

`GET /organization/usage/can-consume/{resource_kind}`

Whether one more unit of ``resource_kind`` may be consumed now. Writes nothing.

The organization and the person come from the caller's own credentials rather
than from the request, so no caller can read another organization's budgets or
attribute the question to somebody else.

The instant evaluated is now, which is what selects each policy's window. A
caller holding this answer across a window boundary is holding a stale one.

## Path parameters

- `resource_kind` 'investigation', required — A category of product activity metered and governed on its own. Two activities are different kinds when their accounting or entitlement behavior differs, not merely because a user would name them differently.

## Query parameters

- `trigger_type` 'manual' | 'auto-trigger' | 'slack_mention' | 'slack_dm' | 'slack_investigate_command' | 'slack_channel_join_auto_trigger' | 'slack_message_auto_trigger' | 'topology_explore' | 'alert_chat' | 'alert_event_manual_investigate' | 'alert_event_anomaly_detected_investigate' | 'alert_event_critical_severity_investigate' | 'proactive_followup' | 'alert_story' | 'alert_summary' | 'api' | 'mcp' | 'channel_agent' | 'deep_wiki' | 'autoresearch' | 'ensemble_member' | 'incident_monitor_postmortem'

## Response `200`

Successful Response

- CanConsumeResponse — Response for ``GET /organization/usage/can-consume/{resource_kind}``.
  - `can_consume` boolean, required — False only when a limited policy the caller draws on is at or over its limit.

## Other responses

- `422` — Validation Error

## Changes

> 57 revisions in range; 9 not diffed.

- **2026-09-10** `47dcc19b4add` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/traversal/apis/fastapi/changes/organization/usage/can-consume/:resource_kind/get.md)

---

[API](https://skmtc.dev/traversal/apis/fastapi.md) · [All operations](https://skmtc.dev/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/traversal/apis/fastapi/revisions/c3bd9dec6c16?raw)