AI Studio usage API

AiStudioRun

Property	Type	Description
`gid`	string	Globally unique identifier of the resource, as a string.
`resource_type`	string	The base type of this resource.
`rule`	object	The rule (automation) that ran, as a compact reference. The Rules API is not yet public, so this is not dereferenceable today, but the shape is forward-compatible (consumers can key off `rule.gid`).
`rule.gid`	string
`rule.resource_type`	string
`rule.name`	string
`rule_owner`	object	The user who owns the rule.
`rule_owner.gid`	string	Globally unique identifier of the resource, as a string.
`rule_owner.resource_type`	string	The base type of this resource.
`rule_owner.name`	string	Read-only except when same user as requester. The user's name.
`rule_owner.email`	string
`triggered_by`	object	The user the run executed as, and to whom the credits are attributed. Usually the same as `rule_owner`, but can differ for chained or AI-teammate-triggered runs.
`triggered_by.gid`	string	Globally unique identifier of the resource, as a string.
`triggered_by.resource_type`	string	The base type of this resource.
`triggered_by.name`	string	Read-only except when same user as requester. The user's name.
`triggered_by.email`	string
`triggering_container`	object	The object the rule lives in (its container) — a project or portfolio — as a compact reference. `null` if the container is unavailable.
`triggering_container.gid`	string
`triggering_container.resource_type`	string	Click to show all enum values `portfolio` `project`
`division`	object	The division the actor belonged to at the time of the run, as a compact reference. `null` when division metering is not enabled for the domain. Not dereferenceable yet (no public Division API); `name` reflects the division's current state.
`division.gid`	string
`division.resource_type`	string
`division.name`	string
`run_started_at`	string (date-time)	When the run was triggered.
`run_completed_at`	string (date-time)	When the run finished. `null` for runs that did not complete (e.g. cancelled). Runs still in progress don't appear in this endpoint (a usage record exists only once a run is metered), so this is non-null for every success/failed run.
`status`	string	The outcome of the run. Click to show all enum values `cancelled` `failed` `success`
`model`	string	The LLM model used for the run.
`credits_used`	number	The number of credits consumed by the run.
`credit_source`	string	Whether the credits were drawn from a paid or free balance. Click to show all enum values `free` `paid`

Example JSON for AiStudioRun:

{
  "gid": "12345",
  "resource_type": "ai_studio_run",
  "rule": {
    "gid": "1208111111111111",
    "resource_type": "rule",
    "name": "Auto-summarize incoming requests"
  },
  "rule_owner": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez",
    "email": "[email protected]"
  },
  "triggered_by": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez",
    "email": "[email protected]"
  },
  "triggering_container": {
    "gid": "1206000000000001",
    "resource_type": "project"
  },
  "division": {
    "gid": "1205000000000003",
    "resource_type": "division",
    "name": "Engineering"
  },
  "run_started_at": "2026-05-01T14:03:12.000Z",
  "run_completed_at": "2026-05-01T14:03:15.220Z",
  "status": "example string",
  "model": "claude-sonnet-4-6",
  "credits_used": 12,
  "credit_source": "example string"
}

AiStudioSeat

Property	Type	Description
`gid`	string	Globally unique identifier of the resource, as a string.
`resource_type`	string	The base type of this resource.
`user`	object	The user who holds the seat.
`user.gid`	string	Globally unique identifier of the resource, as a string.
`user.resource_type`	string	The base type of this resource.
`user.name`	string	Read-only except when same user as requester. The user's name.
`user.email`	string
`license`	string	The user's effective AI Studio license tier. `/seats` returns only paid seats, so the free tier is not included. Click to show all enum values `ai_studio_max` `ai_studio_plus` `ai_studio_pro`
`state`	string	The state of the seat. Click to show all enum values `active` `expired` `revoked`
`assigned_at`	string (date-time)	When the seat was granted/assigned.
`revoked_at`	string (date-time)	When the seat was revoked or expired. `null` for active seats.
`assigned_by`	object	The user who assigned the seat. `null` when assigned by the system.
`assigned_by.gid`	string	Globally unique identifier of the resource, as a string.
`assigned_by.resource_type`	string	The base type of this resource.
`assigned_by.name`	string	Read-only except when same user as requester. The user's name.

Example JSON for AiStudioSeat:

{
  "gid": "12345",
  "resource_type": "ai_studio_seat",
  "user": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez",
    "email": "[email protected]"
  },
  "license": "example string",
  "state": "example string",
  "assigned_at": "2026-03-01T00:00:00.000Z",
  "revoked_at": "example string",
  "assigned_by": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  }
}