Skip to main content
Version: Beta

AiUsageInput

description

Input parameters for querying AI usage records. Supports date range filtering and offset-based pagination.

input AiUsageInput {
  from: DateTime
  to: DateTime
  limit: Int
  offset: Int
}

Fields​

AiUsageInput.from ● DateTime scalar graph-ql-types​

Start date for filtering usage (inclusive).

Format: ISO 8601 DateTime string in UTC (YYYY-MM-DDTHH:mm:ss.sssZ)

Examples:

  • "2025-11-02T00:00:00Z" - Start of November 2, 2025 (midnight UTC)
  • "2025-11-02T14:30:00Z" - November 2, 2025 at 2:30 PM UTC
  • "2025-11-02T00:00:00.000Z" - With milliseconds

Tip: For date-only filtering, use T00:00:00Z suffix (midnight UTC). Note: Date-only format "2025-11-02" is NOT supported - you must include time component.

AiUsageInput.to ● DateTime scalar graph-ql-types​

End date for filtering usage (inclusive).

Format: ISO 8601 DateTime string in UTC (YYYY-MM-DDTHH:mm:ss.sssZ)

Examples:

  • "2025-11-02T23:59:59Z" - End of November 2, 2025 (last second UTC)
  • "2025-11-03T00:00:00Z" - Start of November 3 (to get full day of Nov 2)
  • "2025-11-30T23:59:59.999Z" - Last millisecond of November 30

Tip: To get a full day, use T23:59:59Z or use the next day at T00:00:00Z. Note: Date-only format "2025-11-02" is NOT supported - you must include time component.

AiUsageInput.limit ● Int scalar graph-ql-types​

Number of records to return per page (default: 20, max: 100)

AiUsageInput.offset ● Int scalar graph-ql-types​

Number of records to skip (for pagination)

Member Of​

aiUsage query