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

# Can Consume

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

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/organization/usage/can-consume/{resource_kind}`
- Auth: none declared

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' | 'chat_mention' | 'chat_dm' | 'chat_investigate_command' | 'chat_channel_join_auto_trigger' | 'chat_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' | 'slack_mention' | 'slack_dm' | 'slack_investigate_command' | 'slack_channel_join_auto_trigger' | 'slack_message_auto_trigger'

## 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

> 66 revisions in range; 9 not diffed.

- **2026-09-29** `c939e4d80cd7`: 5 info
  - added the new enum value `chat_channel_join_auto_trigger` to the `query` request parameter `trigger_type`
  - added the new enum value `chat_dm` to the `query` request parameter `trigger_type`
  - added the new enum value `chat_investigate_command` to the `query` request parameter `trigger_type`
  - added the new enum value `chat_mention` to the `query` request parameter `trigger_type`
  - …1 more
- **2026-09-10** `47dcc19b4add`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)