Skip to content

Asana: AI studio usage API schemas

14 Asana schemas with complete fields and constraints.

← AI studio usage API operations · All schemas

Get AI Studio credit utilization — response body — data, next page

FieldTypePresenceDescription and constraints
$objectRoot
dataarrayRequired within parent
data[]ModelEach itemExpand Get AI Studio credit utilization — response body — data, next page data item — sdk__Ai Studio Run Response
next_pageModelOptionalExpand Get goals — response body — data, next page next page

Referenced models: Get goals — response body — data, next page next page, Get AI Studio credit utilization — response body — data, next page data item — sdk__Ai Studio Run Response

Get AI Studio credit utilization — response body — data, next page data item automation gid, name, resource type

FieldTypePresenceDescription and constraints
$objectRootThe multi-step automation (AutomationWorkflow) the step belonged to when it ran. `null` for standalone rules. Non-null for workflow steps regardless of whether the step itself was later deleted. Each step of a multi-step automation run is returned as its own row with the same `automation`, so group by `automation.gid` to reconstruct per-automation usage. Not dereferenceable yet (no public Automations API).
Read only: true
gidstringOptionalRead only: true
resource_typestringOptionalRead only: true
namestringOptionalRead only: true

Get AI Studio credit utilization — response body — data, next page data item gid, resource type

FieldTypePresenceDescription and constraints
$objectRootA single AI Studio run (rule execution), representing the credits consumed by one execution of an AI Studio rule.
gidstringOptionalGlobally unique identifier of the resource, as a string.
Read only: true
resource_typestringOptionalThe base type of this resource.
Read only: true

Get AI Studio credit utilization — response body — data, next page data item rule gid, name, resource type

FieldTypePresenceDescription and constraints
$objectRootThe rule (AutomationStep) that ran, as a compact reference. Non-null for both standalone rules and multi-step automation steps as long as the step still exists. `null` if the step was deleted after the run. 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`).
Read only: true
gidstringOptionalRead only: true
resource_typestringOptionalRead only: true
namestringOptionalRead only: true

Get AI Studio credit utilization — response body — data, next page data item rule owner

FieldTypePresenceDescription and constraints
$objectRootA generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
The user who owns the rule.
Read only: true
gidstringOptionalGlobally unique identifier of the resource, as a string.
Read only: true
resource_typestringOptionalThe base type of this resource.
Read only: true
namestringOptional*Read-only except when same user as requester*. The user's name.
emailstringOptionalRead only: true

Get AI Studio credit utilization — response body — data, next page data item triggered by

FieldTypePresenceDescription and constraints
$objectRootA generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
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.
Read only: true
gidstringOptionalGlobally unique identifier of the resource, as a string.
Read only: true
resource_typestringOptionalThe base type of this resource.
Read only: true
namestringOptional*Read-only except when same user as requester*. The user's name.
emailstringOptionalRead only: true

Get AI Studio credit utilization — response body — data, next page data item — Ai Studio Run Response

FieldTypePresenceDescription and constraints
$JSONRoot
$ (allOf 1)ModelAll variants applyExpand Get AI Studio credit utilization — response body — data, next page data item gid, resource type
$ (allOf 2)objectAll variants applyA single AI Studio run (rule execution). The `gid` is stable and serves as the de-duplication key for incremental loads.
$ (allOf 2).ruleJSONOptional
$ (allOf 2).rule (anyOf 1)ModelAlternativeExpand Get AI Studio credit utilization — response body — data, next page data item rule gid, name, resource type
$ (allOf 2).rule (anyOf 2)nullAlternative
$ (allOf 2).automationJSONOptional
$ (allOf 2).automation (anyOf 1)ModelAlternativeExpand Get AI Studio credit utilization — response body — data, next page data item automation gid, name, resource type
$ (allOf 2).automation (anyOf 2)nullAlternative
$ (allOf 2).rule_ownerJSONOptional
$ (allOf 2).rule_owner (allOf 1)ModelAll variants applyExpand Get users in a team — response body — data data item
$ (allOf 2).rule_owner (allOf 2)objectAll variants applyThe user who owns the rule.
Read only: true
$ (allOf 2).rule_owner (allOf 2).emailstringOptionalRead only: true
$ (allOf 2).triggered_byJSONOptional
$ (allOf 2).triggered_by (allOf 1)ModelAll variants applyExpand Get users in a team — response body — data data item
$ (allOf 2).triggered_by (allOf 2)objectAll variants applyThe 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.
Read only: true
$ (allOf 2).triggered_by (allOf 2).emailstringOptionalRead only: true
$ (allOf 2).triggering_containerJSONOptional
$ (allOf 2).triggering_container (anyOf 1)objectAlternativeThe object the rule lives in (its container) — a project or portfolio — as a compact reference. `null` if the container is unavailable.
Read only: true
$ (allOf 2).triggering_container (anyOf 1).gidstringOptionalRead only: true
$ (allOf 2).triggering_container (anyOf 1).resource_typestringOptionalKnown values: project, portfolio
Read only: true
$ (allOf 2).triggering_container (anyOf 2)nullAlternative
$ (allOf 2).divisionJSONOptional
$ (allOf 2).division (anyOf 1)objectAlternativeThe 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.
Read only: true
$ (allOf 2).division (anyOf 1).gidstringOptionalRead only: true
$ (allOf 2).division (anyOf 1).resource_typestringOptionalRead only: true
$ (allOf 2).division (anyOf 1).namestringOptionalRead only: true
$ (allOf 2).division (anyOf 2)nullAlternative
$ (allOf 2).run_started_atJSONOptional
$ (allOf 2).run_started_at (anyOf 1)stringAlternativeWhen the run was triggered.
Format: date-time
Read only: true
$ (allOf 2).run_started_at (anyOf 2)nullAlternative
$ (allOf 2).run_completed_atJSONOptional
$ (allOf 2).run_completed_at (anyOf 1)stringAlternativeWhen 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.
Format: date-time
Read only: true
$ (allOf 2).run_completed_at (anyOf 2)nullAlternative
$ (allOf 2).statusstringOptionalThe outcome of the run.
Known values: success, failed, cancelled
Read only: true
$ (allOf 2).modelstringOptionalThe LLM model used for the run.
Read only: true
$ (allOf 2).credits_usedJSONOptional
$ (allOf 2).credits_used (anyOf 1)numberAlternativeThe number of credits consumed by the run.
Read only: true
$ (allOf 2).credits_used (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (allOf 2).credit_sourcestringOptionalWhether the credits were drawn from a paid or free balance.
Known values: paid, free
Read only: true

Referenced models: Get AI Studio credit utilization — response body — data, next page data item gid, resource type, Get users in a team — response body — data data item, Get AI Studio credit utilization — response body — data, next page data item automation gid, name, resource type, Get AI Studio credit utilization — response body — data, next page data item rule gid, name, resource type

Get AI Studio credit utilization — response body — data, next page data item — sdk__Ai Studio Run Response

FieldTypePresenceDescription and constraints
$objectRootA generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A single AI Studio run (rule execution), representing the credits consumed by one execution of an AI Studio rule.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A single AI Studio run (rule execution), representing the credits consumed by one execution of an AI Studio rule.
A single AI Studio run (rule execution). The `gid` is stable and serves as the de-duplication key for incremental loads.
gidstringOptionalGlobally unique identifier of the resource, as a string.
Read only: true
resource_typestringOptionalThe base type of this resource.
Read only: true
ruleJSONOptional
rule (anyOf 1)ModelAlternativeExpand Get AI Studio credit utilization — response body — data, next page data item rule gid, name, resource type
rule (anyOf 2)nullAlternative
automationJSONOptional
automation (anyOf 1)ModelAlternativeExpand Get AI Studio credit utilization — response body — data, next page data item automation gid, name, resource type
automation (anyOf 2)nullAlternative
rule_ownerModelOptionalExpand Get AI Studio credit utilization — response body — data, next page data item rule owner
triggered_byModelOptionalExpand Get AI Studio credit utilization — response body — data, next page data item triggered by
triggering_containerJSONOptional
triggering_container (anyOf 1)objectAlternativeThe object the rule lives in (its container) — a project or portfolio — as a compact reference. `null` if the container is unavailable.
Read only: true
triggering_container (anyOf 1).gidstringOptionalRead only: true
triggering_container (anyOf 1).resource_typestringOptionalKnown values: project, portfolio
Read only: true
triggering_container (anyOf 2)nullAlternative
divisionJSONOptional
division (anyOf 1)objectAlternativeThe 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.
Read only: true
division (anyOf 1).gidstringOptionalRead only: true
division (anyOf 1).resource_typestringOptionalRead only: true
division (anyOf 1).namestringOptionalRead only: true
division (anyOf 2)nullAlternative
run_started_atJSONOptional
run_started_at (anyOf 1)stringAlternativeWhen the run was triggered.
Format: date-time
Read only: true
run_started_at (anyOf 2)nullAlternative
run_completed_atJSONOptional
run_completed_at (anyOf 1)stringAlternativeWhen 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.
Format: date-time
Read only: true
run_completed_at (anyOf 2)nullAlternative
statusstringOptionalThe outcome of the run.
Known values: success, failed, cancelled
Read only: true
modelstringOptionalThe LLM model used for the run.
Read only: true
credits_usedJSONOptional
credits_used (anyOf 1)numberAlternativeThe number of credits consumed by the run.
Read only: true
credits_used (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
credit_sourcestringOptionalWhether the credits were drawn from a paid or free balance.
Known values: paid, free
Read only: true

Referenced models: Get AI Studio credit utilization — response body — data, next page data item automation gid, name, resource type, Get AI Studio credit utilization — response body — data, next page data item rule owner, Get AI Studio credit utilization — response body — data, next page data item rule gid, name, resource type, Get AI Studio credit utilization — response body — data, next page data item triggered by

Get AI Studio seats — response body — data, next page

FieldTypePresenceDescription and constraints
$objectRoot
dataarrayRequired within parent
data[]ModelEach itemExpand Get AI Studio seats — response body — data, next page data item — sdk__Ai Studio Seat Response
next_pageModelOptionalExpand Get goals — response body — data, next page next page

Referenced models: Get goals — response body — data, next page next page, Get AI Studio seats — response body — data, next page data item — sdk__Ai Studio Seat Response

Get AI Studio seats — response body — data, next page data item assigned by gid, name, resource type

FieldTypePresenceDescription and constraints
$objectRootA generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
The user who assigned the seat. `null` when assigned by the system.
Read only: true
gidstringOptionalGlobally unique identifier of the resource, as a string.
Read only: true
resource_typestringOptionalThe base type of this resource.
Read only: true
namestringOptional*Read-only except when same user as requester*. The user's name.

Get AI Studio seats — response body — data, next page data item gid, resource type

FieldTypePresenceDescription and constraints
$objectRootA single AI Studio seat allocation, representing one user's access to AI Studio in the workspace.
gidstringOptionalGlobally unique identifier of the resource, as a string.
Read only: true
resource_typestringOptionalThe base type of this resource.
Read only: true

Get AI Studio seats — response body — data, next page data item user

FieldTypePresenceDescription and constraints
$objectRootA generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
The user who holds the seat.
Read only: true
gidstringOptionalGlobally unique identifier of the resource, as a string.
Read only: true
resource_typestringOptionalThe base type of this resource.
Read only: true
namestringOptional*Read-only except when same user as requester*. The user's name.
emailstringOptionalRead only: true

Get AI Studio seats — response body — data, next page data item — Ai Studio Seat Response

FieldTypePresenceDescription and constraints
$JSONRoot
$ (allOf 1)ModelAll variants applyExpand Get AI Studio seats — response body — data, next page data item gid, resource type
$ (allOf 2)objectAll variants applyA single AI Studio seat allocation (current snapshot).
$ (allOf 2).userJSONOptional
$ (allOf 2).user (allOf 1)ModelAll variants applyExpand Get users in a team — response body — data data item
$ (allOf 2).user (allOf 2)objectAll variants applyThe user who holds the seat.
Read only: true
$ (allOf 2).user (allOf 2).emailstringOptionalRead only: true
$ (allOf 2).licensestringOptionalThe user's effective AI Studio license tier. `/seats` returns only paid seats, so the free tier is not included.
Known values: ai_studio_plus, ai_studio_pro, ai_studio_max
Read only: true
$ (allOf 2).statestringOptionalThe state of the seat.
Known values: active, revoked, expired
Read only: true
$ (allOf 2).assigned_atstringOptionalWhen the seat was granted/assigned.
Format: date-time
Read only: true
$ (allOf 2).revoked_atJSONOptional
$ (allOf 2).revoked_at (anyOf 1)stringAlternativeWhen the seat was revoked or expired. `null` for active seats.
Format: date-time
Read only: true
$ (allOf 2).revoked_at (anyOf 2)nullAlternative
$ (allOf 2).assigned_byJSONOptional
$ (allOf 2).assigned_by (anyOf 1)JSONAlternative
$ (allOf 2).assigned_by (anyOf 1) (allOf 1)ModelAll variants applyExpand Get users in a team — response body — data data item
$ (allOf 2).assigned_by (anyOf 1) (allOf 2)objectAll variants applyThe user who assigned the seat. `null` when assigned by the system.
Read only: true
$ (allOf 2).assigned_by (anyOf 2)nullAlternative

Referenced models: Get AI Studio seats — response body — data, next page data item gid, resource type, Get users in a team — response body — data data item

Get AI Studio seats — response body — data, next page data item — sdk__Ai Studio Seat Response

FieldTypePresenceDescription and constraints
$objectRootA generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A single AI Studio seat allocation, representing one user's access to AI Studio in the workspace.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A single AI Studio seat allocation, representing one user's access to AI Studio in the workspace.
A single AI Studio seat allocation (current snapshot).
gidstringOptionalGlobally unique identifier of the resource, as a string.
Read only: true
resource_typestringOptionalThe base type of this resource.
Read only: true
userModelOptionalExpand Get AI Studio seats — response body — data, next page data item user
licensestringOptionalThe user's effective AI Studio license tier. `/seats` returns only paid seats, so the free tier is not included.
Known values: ai_studio_plus, ai_studio_pro, ai_studio_max
Read only: true
statestringOptionalThe state of the seat.
Known values: active, revoked, expired
Read only: true
assigned_atstringOptionalWhen the seat was granted/assigned.
Format: date-time
Read only: true
revoked_atJSONOptional
revoked_at (anyOf 1)stringAlternativeWhen the seat was revoked or expired. `null` for active seats.
Format: date-time
Read only: true
revoked_at (anyOf 2)nullAlternative
assigned_byJSONOptional
assigned_by (anyOf 1)ModelAlternativeExpand Get AI Studio seats — response body — data, next page data item assigned by gid, name, resource type
assigned_by (anyOf 2)nullAlternative

Referenced models: Get AI Studio seats — response body — data, next page data item assigned by gid, name, resource type, Get AI Studio seats — response body — data, next page data item user

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.