Developer
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Last updated Oct 29, 2025

Atlas project has project update

The AtlasProjectHasProjectUpdate relationship represents the link between a Townsquare project and a Townsquare project update within the Teamwork Graph. It allows you to:

  • Retrieve updates for a specific Atlas project
  • Find which Atlas project an update belongs to
  • Traverse and analyze project-update relationships

Relationship type: Canonical

From object typeTo object type
Townsquare project - ati:cloud:townsquare:projectTownsquare project Update - ati:cloud:townsquare:project-update

Cypher

We recommend using parameterized Cypher queries rather than placing parameters directly in the query string. This helps improve performance.

Forward query

GraphQL
1
2
query AtlasProjectHasProjectUpdate_CypherQuery($cypherQuery: String!, $params: JSON!) {
 graphStore @optIn(to: ["GraphStore", "GraphStoreCypherQueryV2"]) {
  cypherQueryV2(query: $cypherQuery, params: $params) {
   edges {
    node {
     columns {
      key
      value {. on GraphStoreCypherQueryV2NodeList {
        nodes {
         data {. on TownsquareProjectUpdate {
           id
          }
         }
        }
       }. on GraphStoreCypherQueryV2AriNode {
        data {. on TownsquareProjectUpdate {
          id
         }
        }
       }. on GraphStoreCypherQueryV2BooleanObject {
        bool_val: value
       }. on GraphStoreCypherQueryV2IntObject {
        int_val: value
       }. on GraphStoreCypherQueryV2FloatObject {
        float_val: value
       }. on GraphStoreCypherQueryV2StringObject {
        str_val: value
       }
      }
     }
    }
   }
  }
 }
}
Params
1
2
{
 "cypherQuery": "MATCH (project:TownsquareProject {ari: $id})-[:atlas_project_has_project_update]->(update:TownsquareProjectUpdate) RETURN update",
 "params": {
  "id": "$id"
 }
}

Inverse query

GraphQL
1
2
query AtlasProjectHasProjectUpdate_CypherQuery($cypherQuery: String!, $params: JSON!) {
 graphStore @optIn(to: ["GraphStore", "GraphStoreCypherQueryV2"]) {
  cypherQueryV2(query: $cypherQuery, params: $params) {
   edges {
    node {
     columns {
      key
      value {. on GraphStoreCypherQueryV2NodeList {
        nodes {
         data {. on TownsquareProject {
           id
          }
         }
        }
       }. on GraphStoreCypherQueryV2AriNode {
        data {. on TownsquareProject {
          id
         }
        }
       }. on GraphStoreCypherQueryV2BooleanObject {
        bool_val: value
       }. on GraphStoreCypherQueryV2IntObject {
        int_val: value
       }. on GraphStoreCypherQueryV2FloatObject {
        float_val: value
       }. on GraphStoreCypherQueryV2StringObject {
        str_val: value
       }
      }
     }
    }
   }
  }
 }
}
Params
1
2
{
 "cypherQuery": "MATCH (project:TownsquareProject)-[:atlas_project_has_project_update]->(update:TownsquareProjectUpdate {ari: $id}) RETURN project",
 "params": {
  "id": "$id"
 }
}

Metadata

This relationship is not indexed. You will not be able to filter by this metadata when querying this relationship.

To metadata

NameTypeDescription
oldStatusOldStatus (Enum)Previous status of the project before this update.
newStatusNewStatus (Enum)New status of the project after this update.
oldTargetDateLongPrevious target completion date timestamp.
oldConfidenceOldConfidence (Enum)Previous confidence level in meeting project goals.
newTargetDateLongNew target completion date timestamp.
newConfidenceNewConfidence (Enum)New confidence level in meeting project goals.
updateTypeUpdateType (Enum)Type of update that was made to the project.
createdByAri (Message)ARI of the user who created this project update.
creationDateLongTimestamp when this project update was created.
lastEditedByAri (Message)ARI of the user who last edited this project update.
lastUpdatedLongTimestamp when this project update was last modified.

Ari

When filtering by ARI in GraphQL, it will behave as a String rather than a message as shown below.

NameTypeDescription
valueStringThe ARI string value identifying the user or resource.

OldStatus

NameInternal NameIndexDescription
NOT_SETOLD_STATUS_NOT_SET0No previous status has been set for this project.
NULLOLD_STATUS_NULL100Previous status was explicitly set to null.
OFF_TRACKOLD_STATUS_OFF_TRACK110Project was previously off track and unlikely to meet goals.
AT_RISKOLD_STATUS_AT_RISK120Project was previously at risk of missing targets.
ON_TRACKOLD_STATUS_ON_TRACK130Project was previously on track to meet goals.
PENDINGOLD_STATUS_PENDING140Project was previously in a pending state awaiting action.
PAUSEDOLD_STATUS_PAUSED150Project was previously paused and not actively worked on.
DONEOLD_STATUS_DONE160Project was previously completed successfully.
CANCELLEDOLD_STATUS_CANCELLED170Project was previously cancelled and will not be completed.

NewStatus

NameInternal NameIndexDescription
NOT_SETNEW_STATUS_NOT_SET0No new status has been set for this project.
OFF_TRACKNEW_STATUS_OFF_TRACK110Project is now off track and unlikely to meet goals.
AT_RISKNEW_STATUS_AT_RISK120Project is now at risk of missing targets.
ON_TRACKNEW_STATUS_ON_TRACK130Project is now on track to meet goals.
PENDINGNEW_STATUS_PENDING140Project is now in a pending state awaiting action.
PAUSEDNEW_STATUS_PAUSED150Project is now paused and not actively worked on.
DONENEW_STATUS_DONE160Project is now completed successfully.
CANCELLEDNEW_STATUS_CANCELLED170Project is now cancelled and will not be completed.

OldConfidence

NameInternal NameIndexDescription
NOT_SETOLD_CONFIDENCE_NOT_SET0No previous confidence level was set for this project.
NULLOLD_CONFIDENCE_NULL100Previous confidence level was explicitly set to null.
DAYOLD_CONFIDENCE_DAY110Previously confident in meeting targets within a day's accuracy.
MONTHOLD_CONFIDENCE_MONTH120Previously confident in meeting targets within a month's accuracy.
QUARTEROLD_CONFIDENCE_QUARTER130Previously confident in meeting targets within a quarter's accuracy.

NewConfidence

NameInternal NameIndexDescription
NOT_SETNEW_CONFIDENCE_NOT_SET0No new confidence level has been set for this project.
DAYNEW_CONFIDENCE_DAY110Now confident in meeting targets within a day's accuracy.
MONTHNEW_CONFIDENCE_MONTH120Now confident in meeting targets within a month's accuracy.
QUARTERNEW_CONFIDENCE_QUARTER130Now confident in meeting targets within a quarter's accuracy.

UpdateType

NameInternal NameIndexDescription
NOT_SETUPDATE_TYPE_NOT_SET0No update type has been specified.
SYSTEMUPDATE_TYPE_SYSTEM110Update was generated automatically by the system.
USERUPDATE_TYPE_USER120Update was created manually by a user.

Rate this page: