GET/projects/api/v3/projects/updates.json

Get all project updates

Return the updates from all projects that the logged-in user can access.

Query Params

  • Name
    updatedAfter
    Type
    string
    Description

    filter by updated after

  • Name
    projectStatus
    Type
    string
    Description

    filter by project status

  • Name
    orderMode
    Type
    string
    Description

    order mode

    Default
    asc
    Allowed values
    • asc
    • desc
  • Name
    orderBy
    Type
    string
    Description

    order by

    Default
    date
    Allowed values
    • date
    • color
    • health
    • project
    • user
  • Name
    createdAfter
    Type
    string
    Description

    filter by creation date

  • Name
    projectId
    Type
    integer
    Description

    filter by project id

  • Name
    pageSize
    Type
    integer
    Description

    number of items in a page

    Default
    50
  • Name
    page
    Type
    integer
    Description

    page number

    Default
    1
  • Name
    skipCounts
    Type
    boolean
    Description

    SkipCounts allows you to skip doing counts on a list API endpoint for performance reasons.

  • Name
    showDeleted
    Type
    boolean
    Description

    include deleted items

    Default
    false
  • Name
    reactions
    Type
    boolean
    Description

    add reactions to the response

    Default
    false
  • Name
    onlyStarredProjects
    Type
    boolean
    Description

    filter by starred projects only

  • Name
    matchAllProjectTags
    Type
    boolean
    Description

    match all project tags

  • Name
    includeArchivedProjects
    Type
    boolean
    Description

    include archived projects

  • Name
    emoji
    Type
    boolean
    Description

    parse emojis to unicode

    Default
    true
  • Name
    activeOnly
    Type
    boolean
    Description

    filter by active

    Default
    true
  • Name
    projectTagIds
    Type
    array[integer]
    Description

    filter by project tag ids

    Format
    Comma separated values
  • Name
    projectStatuses
    Type
    array[string]
    Description

    list of project status

    Format
    Comma separated values
  • Name
    projectOwnerIds
    Type
    array[integer]
    Description

    filter by project owner ids

    Format
    Comma separated values
  • Name
    projectHealths
    Type
    array[integer]
    Description

    filter by project health

    Format
    Comma separated values
  • Name
    projectHealth
    Type
    array[integer]
    Description

    filter by project health (deprecated, use projectHealths)

    Format
    Comma separated values
  • Name
    projectCompanyIds
    Type
    array[integer]
    Description

    filter by company ids

    Format
    Comma separated values
  • Name
    projectCategoryIds
    Type
    array[integer]
    Description

    filter by project category ids

    Format
    Comma separated values
  • Name
    include
    Type
    array[string]
    Description

    include

    Format
    Comma separated values
    Allowed values
    • projects
    • createdBy
    • deletedBy
    • likes.users
  • Name
    fields[users]
    Type
    array[string]
    Description
    Format
    Comma separated values
    Allowed values
    • id
    • firstName
    • lastName
    • title
    • email
    • companyId
    • company
    • isAdmin
    • isClientUser
    • isServiceAccount
    • type
    • deleted
    • avatarUrl
    • lengthOfDay
    • workingHoursId
    • workingHour
    • userRate
    • userCost
    • canAddProjects
  • Name
    fields[projects]
    Type
    array[string]
    Description
    Format
    Comma separated values
    Allowed values
    • id
    • name
  • Name
    fields[projectUpdates]
    Type
    array[string]
    Description
    Format
    Comma separated values
    Allowed values
    • id
    • projectId
    • text
    • isActive
    • health
    • color
    • dateCreated
    • deleted
    • deletedDate
    • numLikes
    • reactions

Responses

  • Code
    200
    Type
    object
    Schema
    Description
    200 OK
    ProjectUpdatesResponse contains information about a group of updates.
  • Code
    400
    Type
    object
    Schema
    Description
    400 Bad Request
    ErrorResponse defines how []Error should be marshaled to JSON.

Examples

200 OK

ProjectUpdatesResponse
{  "included": {    "projects": {      "additionalProp": {        "activePages": {          "billing": true,          "board": true,          "comments": true,          "files": true,          "finance": true,          "forms": true,          "gantt": true,          "links": true,          "list": true,          "messages": true,          "milestones": true,          "notebooks": true,          "proofs": true,