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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
data | array | Required within parent | |
data[] | Model | Each item | Expand Get AI Studio credit utilization — response body — data, next page data item — sdk__Ai Studio Run Response |
next_page | Model | Optional | Expand 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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | The 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 |
gid | string | Optional | Read only: true |
resource_type | string | Optional | Read only: true |
name | string | Optional | Read only: true |
Get AI Studio credit utilization — response body — data, next page data item gid, resource type
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A single AI Studio run (rule execution), representing the credits consumed by one execution of an AI Studio rule. |
gid | string | Optional | Globally unique identifier of the resource, as a string. Read only: true |
resource_type | string | Optional | The 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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | The 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 |
gid | string | Optional | Read only: true |
resource_type | string | Optional | Read only: true |
name | string | Optional | Read only: true |
Get AI Studio credit utilization — response body — data, next page data item rule owner
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | 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.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 |
gid | string | Optional | Globally unique identifier of the resource, as a string. Read only: true |
resource_type | string | Optional | The base type of this resource. Read only: true |
name | string | Optional | *Read-only except when same user as requester*. The user's name. |
email | string | Optional | Read only: true |
Get AI Studio credit utilization — response body — data, next page data item triggered by
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | 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.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 |
gid | string | Optional | Globally unique identifier of the resource, as a string. Read only: true |
resource_type | string | Optional | The base type of this resource. Read only: true |
name | string | Optional | *Read-only except when same user as requester*. The user's name. |
email | string | Optional | Read only: true |
Get AI Studio credit utilization — response body — data, next page data item — Ai Studio Run Response
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | JSON | Root | |
$ (allOf 1) | Model | All variants apply | Expand Get AI Studio credit utilization — response body — data, next page data item gid, resource type |
$ (allOf 2) | object | All variants apply | A single AI Studio run (rule execution). The `gid` is stable and serves as the de-duplication key for incremental loads. |
$ (allOf 2).rule | JSON | Optional | |
$ (allOf 2).rule (anyOf 1) | Model | Alternative | Expand Get AI Studio credit utilization — response body — data, next page data item rule gid, name, resource type |
$ (allOf 2).rule (anyOf 2) | null | Alternative | |
$ (allOf 2).automation | JSON | Optional | |
$ (allOf 2).automation (anyOf 1) | Model | Alternative | Expand Get AI Studio credit utilization — response body — data, next page data item automation gid, name, resource type |
$ (allOf 2).automation (anyOf 2) | null | Alternative | |
$ (allOf 2).rule_owner | JSON | Optional | |
$ (allOf 2).rule_owner (allOf 1) | Model | All variants apply | Expand Get users in a team — response body — data data item |
$ (allOf 2).rule_owner (allOf 2) | object | All variants apply | The user who owns the rule. Read only: true |
$ (allOf 2).rule_owner (allOf 2).email | string | Optional | Read only: true |
$ (allOf 2).triggered_by | JSON | Optional | |
$ (allOf 2).triggered_by (allOf 1) | Model | All variants apply | Expand Get users in a team — response body — data data item |
$ (allOf 2).triggered_by (allOf 2) | object | All variants apply | 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 |
$ (allOf 2).triggered_by (allOf 2).email | string | Optional | Read only: true |
$ (allOf 2).triggering_container | JSON | Optional | |
$ (allOf 2).triggering_container (anyOf 1) | object | Alternative | The 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).gid | string | Optional | Read only: true |
$ (allOf 2).triggering_container (anyOf 1).resource_type | string | Optional | Known values: project, portfolio Read only: true |
$ (allOf 2).triggering_container (anyOf 2) | null | Alternative | |
$ (allOf 2).division | JSON | Optional | |
$ (allOf 2).division (anyOf 1) | object | Alternative | 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. Read only: true |
$ (allOf 2).division (anyOf 1).gid | string | Optional | Read only: true |
$ (allOf 2).division (anyOf 1).resource_type | string | Optional | Read only: true |
$ (allOf 2).division (anyOf 1).name | string | Optional | Read only: true |
$ (allOf 2).division (anyOf 2) | null | Alternative | |
$ (allOf 2).run_started_at | JSON | Optional | |
$ (allOf 2).run_started_at (anyOf 1) | string | Alternative | When the run was triggered. Format: date-time Read only: true |
$ (allOf 2).run_started_at (anyOf 2) | null | Alternative | |
$ (allOf 2).run_completed_at | JSON | Optional | |
$ (allOf 2).run_completed_at (anyOf 1) | string | Alternative | 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. Format: date-time Read only: true |
$ (allOf 2).run_completed_at (anyOf 2) | null | Alternative | |
$ (allOf 2).status | string | Optional | The outcome of the run. Known values: success, failed, cancelled Read only: true |
$ (allOf 2).model | string | Optional | The LLM model used for the run. Read only: true |
$ (allOf 2).credits_used | JSON | Optional | |
$ (allOf 2).credits_used (anyOf 1) | number | Alternative | The number of credits consumed by the run. Read only: true |
$ (allOf 2).credits_used (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
$ (allOf 2).credit_source | string | Optional | Whether 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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | 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 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. |
gid | string | Optional | Globally unique identifier of the resource, as a string. Read only: true |
resource_type | string | Optional | The base type of this resource. Read only: true |
rule | JSON | Optional | |
rule (anyOf 1) | Model | Alternative | Expand Get AI Studio credit utilization — response body — data, next page data item rule gid, name, resource type |
rule (anyOf 2) | null | Alternative | |
automation | JSON | Optional | |
automation (anyOf 1) | Model | Alternative | Expand Get AI Studio credit utilization — response body — data, next page data item automation gid, name, resource type |
automation (anyOf 2) | null | Alternative | |
rule_owner | Model | Optional | Expand Get AI Studio credit utilization — response body — data, next page data item rule owner |
triggered_by | Model | Optional | Expand Get AI Studio credit utilization — response body — data, next page data item triggered by |
triggering_container | JSON | Optional | |
triggering_container (anyOf 1) | object | Alternative | The 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).gid | string | Optional | Read only: true |
triggering_container (anyOf 1).resource_type | string | Optional | Known values: project, portfolio Read only: true |
triggering_container (anyOf 2) | null | Alternative | |
division | JSON | Optional | |
division (anyOf 1) | object | Alternative | 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. Read only: true |
division (anyOf 1).gid | string | Optional | Read only: true |
division (anyOf 1).resource_type | string | Optional | Read only: true |
division (anyOf 1).name | string | Optional | Read only: true |
division (anyOf 2) | null | Alternative | |
run_started_at | JSON | Optional | |
run_started_at (anyOf 1) | string | Alternative | When the run was triggered. Format: date-time Read only: true |
run_started_at (anyOf 2) | null | Alternative | |
run_completed_at | JSON | Optional | |
run_completed_at (anyOf 1) | string | Alternative | 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. Format: date-time Read only: true |
run_completed_at (anyOf 2) | null | Alternative | |
status | string | Optional | The outcome of the run. Known values: success, failed, cancelled Read only: true |
model | string | Optional | The LLM model used for the run. Read only: true |
credits_used | JSON | Optional | |
credits_used (anyOf 1) | number | Alternative | The number of credits consumed by the run. Read only: true |
credits_used (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
credit_source | string | Optional | Whether 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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
data | array | Required within parent | |
data[] | Model | Each item | Expand Get AI Studio seats — response body — data, next page data item — sdk__Ai Studio Seat Response |
next_page | Model | Optional | Expand 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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | 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.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 |
gid | string | Optional | Globally unique identifier of the resource, as a string. Read only: true |
resource_type | string | Optional | The base type of this resource. Read only: true |
name | string | Optional | *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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A single AI Studio seat allocation, representing one user's access to AI Studio in the workspace. |
gid | string | Optional | Globally unique identifier of the resource, as a string. Read only: true |
resource_type | string | Optional | The base type of this resource. Read only: true |
Get AI Studio seats — response body — data, next page data item user
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | 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.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 |
gid | string | Optional | Globally unique identifier of the resource, as a string. Read only: true |
resource_type | string | Optional | The base type of this resource. Read only: true |
name | string | Optional | *Read-only except when same user as requester*. The user's name. |
email | string | Optional | Read only: true |
Get AI Studio seats — response body — data, next page data item — Ai Studio Seat Response
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | JSON | Root | |
$ (allOf 1) | Model | All variants apply | Expand Get AI Studio seats — response body — data, next page data item gid, resource type |
$ (allOf 2) | object | All variants apply | A single AI Studio seat allocation (current snapshot). |
$ (allOf 2).user | JSON | Optional | |
$ (allOf 2).user (allOf 1) | Model | All variants apply | Expand Get users in a team — response body — data data item |
$ (allOf 2).user (allOf 2) | object | All variants apply | The user who holds the seat. Read only: true |
$ (allOf 2).user (allOf 2).email | string | Optional | Read only: true |
$ (allOf 2).license | string | Optional | The 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).state | string | Optional | The state of the seat. Known values: active, revoked, expired Read only: true |
$ (allOf 2).assigned_at | string | Optional | When the seat was granted/assigned. Format: date-time Read only: true |
$ (allOf 2).revoked_at | JSON | Optional | |
$ (allOf 2).revoked_at (anyOf 1) | string | Alternative | When the seat was revoked or expired. `null` for active seats. Format: date-time Read only: true |
$ (allOf 2).revoked_at (anyOf 2) | null | Alternative | |
$ (allOf 2).assigned_by | JSON | Optional | |
$ (allOf 2).assigned_by (anyOf 1) | JSON | Alternative | |
$ (allOf 2).assigned_by (anyOf 1) (allOf 1) | Model | All variants apply | Expand Get users in a team — response body — data data item |
$ (allOf 2).assigned_by (anyOf 1) (allOf 2) | object | All variants apply | The user who assigned the seat. `null` when assigned by the system. Read only: true |
$ (allOf 2).assigned_by (anyOf 2) | null | Alternative |
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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | 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 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). |
gid | string | Optional | Globally unique identifier of the resource, as a string. Read only: true |
resource_type | string | Optional | The base type of this resource. Read only: true |
user | Model | Optional | Expand Get AI Studio seats — response body — data, next page data item user |
license | string | Optional | The 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 |
state | string | Optional | The state of the seat. Known values: active, revoked, expired Read only: true |
assigned_at | string | Optional | When the seat was granted/assigned. Format: date-time Read only: true |
revoked_at | JSON | Optional | |
revoked_at (anyOf 1) | string | Alternative | When the seat was revoked or expired. `null` for active seats. Format: date-time Read only: true |
revoked_at (anyOf 2) | null | Alternative | |
assigned_by | JSON | Optional | |
assigned_by (anyOf 1) | Model | Alternative | Expand Get AI Studio seats — response body — data, next page data item assigned by gid, name, resource type |
assigned_by (anyOf 2) | null | Alternative |
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