TRtraversal
usage

Can Consume

Changed on

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.

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

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'

What a UI-initiated session is.

Response

Successful Response

can_consumeboolean required

False only when a limited policy the caller draws on is at or over its limit.

Changes

  • c939e4d80cd7Revision changes
    • info

      added the new enum value chat_channel_join_auto_trigger to the query request parameter trigger_type

    • info

      added the new enum value chat_dm to the query request parameter trigger_type

    • info

      added the new enum value chat_investigate_command to the query request parameter trigger_type

    • info

      added the new enum value chat_mention to the query request parameter trigger_type

    • info

      added the new enum value chat_message_auto_trigger to the query request parameter trigger_type

  • 47dcc19b4addRevision changes
    • info

      endpoint added