Projects

To Create, Update, Delete and Query the Projects table.

Table Specific Information

Select

The connector will use the Asana API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the connector.

Id supports the '=' comparison.
workspaceId supports the '=' comparison.
TaskId supports the '=' comparison.
TeamId supports the '=' comparison.

For example, the following queries are processed server side:

SELECT * FROM projects WHERE workspaceId = '1126938837961830'

SELECT * FROM projects WHERE Id = '1128092864672888'

SELECT * FROM projects WHERE TaskId = '1130092964672468'

SELECT * FROM projects WHERE TeamId = '1129514033997890'

In case of UseTypeaheadSearch property set to true, only Name and WorkspaceId columns would be filterable server side with Name supporting '=, LIKE' comparison when LIKE used only in the following ways:

SELECT * FROM Projects WHERE Name = 'abc'

SELECT * FROM Projects WHERE Name LIKE 'abc'

SELECT * FROM Projects WHERE Name LIKE 'abc%'

SELECT * FROM Projects WHERE Name LIKE 'abc%' AND WorkspaceId = '1126938837961830'

Insert

WorkspaceId or TeamId is a mandatory column for inserting into Projects table. For example:

INSERT INTO Projects (Name, Color, StartOn, WorkspaceId, DueOn, public, UserId) VALUES ('ProjectName', 'dark-pink', '2020-03-01', '1126938837961830', '2020-04-30', false, '1130062547672468')

Inserting multiple Followers into Projects table. For example:

INSERT INTO Projects (WorkspaceId, Followers) VALUES ('1126938837961830', '1206414724399714,1207035318501516' )

Update

Following is an example of how to update a Projects table:

UPDATE Projects SET TeamId = '1129514033997890' WHERE Id = '1128092864672888'

Delete

Following is an example of how to delete from Projects table:

DELETE FROM Projects WHERE Id = '1128092864672888'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	True		Globally unique ID of the project.
Name	String	False		Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
Color	String	False		Color of the project. Must be either null or one of: dark-pink, dark-green, dark-blue, dark-red, dark-teal, dark-brown, dark-orange, dark-purple, dark-warm-gray, light-pink, light-green, light-blue, light-red, light-teal, light-yellow, light-orange, light-purple, light-warm-gray. The allowed values are dark-pink, dark-green, dark-blue, dark-red, dark-teal, dark-brown, dark-orange, dark-purple, dark-warm-gray, light-pink, light-green, light-blue, light-red, light-teal, light-brown, light-orange, light-purple, light-warm-gray, green, yellow, red.
CreatedAt	Datetime	True		The time at which this project was created.
ModifiedAt	Datetime	True		The time at which this project was last modified.
StartOn	Date	False		The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format. Note: due_on must be present in the request when setting or unsetting the start_on parameter.
DueOn	Date	False		The day on which this project is due. This takes a date with format YYYY-MM-DD.
DefaultView	String	False		The default view of a project. The allowed values are list, board, calendar, timeline.
Followers	String	False		Followers are a subset of members who receive all notifications for a project.
Archived	Boolean	False		True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.
UserId	String	False	Users.Id	The current owner of the project.
TeamId	String	False	Teams.Id	The team that this project is shared with. This field only exists for projects in organizations.
WorkspaceId	String	True	Workspaces.Id	The workspace or organization this project is associated with. Once created, projects cannot be moved to a different workspace. This attribute can only be specified at creation time.
Public	Boolean	True		True if the project is public to the organization. If false, do not share this project with other users in this organization without explicitly checking to see if they have access. For new integrations, please refer to PrivacySetting column.
Notes	String	False		More detailed, free-form textual information associated with the project.
HTMLNotes	String	False		The notes of the project with formatting as HTML.
Members	String	True		Array of users who are members of this project.
PrivacySetting	String	False		The privacy setting of the project. The allowed values are public_to_workspace, private_to_team, private.
TaskId	String	True	Tasks.Id	Globally unique ID of the Task.
ItemURL	String	True		A url that points directly to the object within Asana.
CurrentStatusUpdateId	String	True		Globally unique identifier of the resource, as a string.
CurrentStatusUpdateResourceType	String	True		The base type of this resource.
CurrentStatusUpdateTitle	String	False		The title of the status update.
CurrentStatusUpdateResourceSubtype	String	True		The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.
ResourceType	String	True		The base type of this resource.
DefaultAccessLevel	String	False		The default access for users or teams who join or are added as members to the project. The allowed values are admin, editor, commenter, viewer.
MinimumAccessLevelForCustomization	String	False		The minimum access level needed for project members to modify this project's workflow and appearance. The allowed values are admin, editor.
MinimumAccessLevelForSharing	String	False		The minimum access level needed for project members to share the project and manage project memberships. The allowed values are admin, editor.
Completed	Boolean	True		True if the project is currently marked complete, false if not.
CompletedAt	Datetime	True		The time at which this project was completed, or null if the project is not completed.
CompletedById	String	True		Globally unique identifier of the resource, as a string.
CompletedByResourceType	String	True		The base type of this resource.
CompletedByName	String	True		Read-only except when same user as requester. The user's name.
Icon	String	True		The icon for a project.
ProjectBriefId	String	True		The project brief associated with this project.
ProjectBriefResourceType	String	True		The project brief associated with this project.
CreatedFromTemplateId	String	True		Id of the project template from which this project was created. If the project was not created from a template, this field will be null.
CreatedFromTemplateResourceType	String	True		Resource type of the project template from which this project was created. If the project was not created from a template, this field will be null.
CreatedFromTemplateName	String	True		Name of the project template from which this project was created. If the project was not created from a template, this field will be null.