/asana-utilities | Type: Application | PCID required: Yes
Tools
asana_utilities_approve_access_request
Approve an access request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
access_request_gid | string | Yes | — | Globally unique identifier for the access request. |
asana_utilities_create_access_request
Create an access request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
data | object | No | — | A request to create shareable access for a user. |
asana_utilities_create_attachment_for_object
Upload an attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
connect_to_app | boolean | No | — | Optional. Only relevant for external attachments with a parent task. A boolean indicating whether the current app should be connected with the attachment for the purposes of showing an app components widget. Requires the app to have been added to a project the parent task is in. This property can only be set if an OAuth token is used to authenticate the request. Criteria for displaying app widget: 1. An OAuth token must be used to authenticate the request 2. The app needs to have its widget_metadata_url configured in the developer console 3. The task the attachment is being attached to must be in a project with the app installed |
file | string | No | — | Required for asana attachments. |
name | string | No | — | The name of the external resource being attached. Required for attachments of type external. |
parent | string | Yes | — | Required identifier of the parent task, project, or project_brief, as a string. |
resource_subtype | string | No | — | The type of the attachment. Must be one of the given values. If not specified, a file attachment of type asana will be assumed. Note that if the value of resource_subtype is external, a parent, name, and url must also be provided. |
url | string | No | — | The URL of the external resource being attached. Required for attachments of type external. |
asana_utilities_create_batch_request
Submit parallel requests Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
data | object | No | — | A request object for use in a batch request. |
asana_utilities_create_graph_export
Initiate a graph export Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
data | object | No | — | A graph_export request starts a job to export data starting from a parent object. |
asana_utilities_create_organization_export
Create an organization export request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
data | object | No | — | An organization_export request starts a job to export the complete data of the given Organization. |
asana_utilities_create_resource_export
Initiate a resource export Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
data | object | No | — | A resource_export request starts a job to bulk export objects for one or more resources. |
asana_utilities_create_status_for_object
Create a status update Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
limit | integer | No | — | Results per page. The number of objects to return per page. The value must be between 1 and 100. |
offset | string | No | — | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
data | object | No | — | The data value |
asana_utilities_create_timesheet_approval_status
Create a timesheet approval status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
data | object | No | — | A request to create a timesheet approval status. |
asana_utilities_create_webhook
Establish a webhook Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
data | object | No | — | The data value |
asana_utilities_delete_attachment
Delete an attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
attachment_gid | string | Yes | — | Globally unique identifier for the attachment. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
asana_utilities_delete_status
Delete a status update Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
status_update_gid | string | Yes | — | The status update to get. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
asana_utilities_delete_webhook
Delete a webhook Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
webhook_gid | string | Yes | — | Globally unique identifier for the webhook. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
asana_utilities_get_access_requests
Get access requests Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
target | string | Yes | — | Globally unique identifier for the target object. |
user | string | No | — | A string identifying a user. This can either be the string “me”, an email, or the gid of a user. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_attachment
Get an attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
attachment_gid | string | Yes | — | Globally unique identifier for the attachment. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_attachments_for_object
Get attachments from an object Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
limit | integer | No | — | Results per page. The number of objects to return per page. The value must be between 1 and 100. |
offset | string | No | — | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request. |
parent | string | Yes | — | Globally unique identifier for object to fetch statuses from. Must be a GID for a project, project_brief, or task. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_audit_log_events
Get audit log events Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workspace_gid | string | Yes | — | Globally unique identifier for the workspace or organization. |
start_at | string | No | — | Filter to events created after this time (inclusive). |
end_at | string | No | — | Filter to events created before this time (exclusive). |
event_type | string | No | — | Filter to events of this type. Refer to the supported audit log events for a full list of values. |
actor_type | string | No | — | Filter to events with an actor of this type. This only needs to be included if querying for actor types without an ID. If actor_gid is included, this should be excluded. |
actor_gid | string | No | — | Filter to events triggered by the actor with this ID. |
resource_gid | string | No | — | Filter to events with this resource ID. |
limit | integer | No | — | Results per page. The number of objects to return per page. The value must be between 1 and 100. |
offset | string | No | — | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request. |
asana_utilities_get_events
Get events on a resource Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
resource | string | Yes | — | A resource ID to subscribe to. The resource can be a task, project, or goal. |
sync | string | No | — | A sync token received from the last request, or none on first sync. Events will be returned from the point in time that the sync token was generated. Note: On your first request, omit the sync token. The response will be the same as for an expired sync token, and will include a new valid sync token.If the sync token is too old (which may happen from time to time) the API will return a 412 Precondition Failed error, and include a fresh sync token in the response. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_job
Get a job by id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
job_gid | string | Yes | — | Globally unique identifier for the job. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_organization_export
Get details on an org export request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
organization_export_gid | string | Yes | — | Globally unique identifier for the organization export. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_status
Get a status update Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
status_update_gid | string | Yes | — | The status update to get. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_statuses_for_object
Get status updates from an object Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
limit | integer | No | — | Results per page. The number of objects to return per page. The value must be between 1 and 100. |
offset | string | No | — | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request. |
parent | string | Yes | — | Globally unique identifier for object to fetch statuses from. Must be a GID for a project, portfolio, or goal. |
created_since | string | No | — | Only return statuses that have been created since the given time. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_time_period
Get a time period Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
time_period_gid | string | Yes | — | Globally unique identifier for the time period. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_time_periods
Get time periods Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
limit | integer | No | — | Results per page. The number of objects to return per page. The value must be between 1 and 100. |
offset | string | No | — | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request. |
start_on | string | No | — | ISO 8601 date string |
end_on | string | No | — | ISO 8601 date string |
workspace | string | Yes | — | Globally unique identifier for the workspace. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_timesheet_approval_status
Get a timesheet approval status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
timesheet_approval_status_gid | string | Yes | — | Globally unique identifier for the timesheet approval status. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_timesheet_approval_statuses
Get multiple timesheet approval statuses Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
workspace | string | Yes | — | Globally unique identifier for the workspace. |
user | string | No | — | Globally unique identifier for the user to filter timesheet approval statuses by. |
from_date | string | No | — | The start date for filtering timesheet approval statuses. |
to_date | string | No | — | The end date for filtering timesheet approval statuses. |
approval_statuses | string | No | — | Filter by approval status. Can be one or more of draft, submitted, approved, or rejected. |
limit | integer | No | — | Results per page. The number of objects to return per page. The value must be between 1 and 100. |
offset | string | No | — | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_webhook
Get a webhook Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
webhook_gid | string | Yes | — | Globally unique identifier for the webhook. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_get_webhooks
Get multiple webhooks Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
limit | integer | No | — | Results per page. The number of objects to return per page. The value must be between 1 and 100. |
offset | string | No | — | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request. |
workspace | string | Yes | — | The workspace to query for webhooks in. |
resource | string | No | — | Only return webhooks for the given resource. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
asana_utilities_reject_access_request
Reject an access request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
access_request_gid | string | Yes | — | Globally unique identifier for the access request. |
asana_utilities_trigger_rule
Trigger a rule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
rule_trigger_gid | string | Yes | — | The ID of the incoming web request trigger. This value is a path parameter that is automatically generated for the API endpoint. |
data | object | No | — | The data value |
asana_utilities_update_timesheet_approval_status
Update a timesheet approval status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
timesheet_approval_status_gid | string | Yes | — | Globally unique identifier for the timesheet approval status. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
data | object | No | — | A request to update a timesheet approval status. |
asana_utilities_update_webhook
Update a webhook Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
webhook_gid | string | Yes | — | Globally unique identifier for the webhook. |
opt_pretty | boolean | No | — | Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
opt_fields | string[] | No | — | This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. |
data | object | No | — | The data value |

