Viewing notifications in inbox

[simon-aira]

Thanks for this tool, very useful!

I was wondering if anyone knows how to fetch (unread) inbox notifications? I'd be happy to use a raw API call, but can't quite figure out how (not too acquainted with GraphQL).

[schpet]

@simon-aira let me know if this works:

Unread count (server-side)

linear api '{ notificationsUnreadCount }'

All notifications

linear api '
query {
  notifications(first: 50) {
    nodes {
      id
      type
      title
      subtitle
      createdAt
      readAt
      url
      actor { name }
      ... on IssueNotification {
        issue { identifier title }
        comment { body }
      }
      ... on ProjectNotification {
        project { name }
        comment { body }
      }
      ... on PullRequestNotification {
        pullRequest { title number url }
      }
      ... on DocumentNotification {
        documentId
      }
    }
  }
}
'

Unread notifications (client-side filter)

The NotificationFilter input type does not expose readAt, so fetch all and filter for null locally:

linear api '
query {
  notifications(first: 50) {
    nodes {
      id
      type
      title
      subtitle
      createdAt
      readAt
      url
      actor { name }
      ... on IssueNotification {
        issue { identifier title }
        comment { body }
      }
      ... on ProjectNotification {
        project { name }
        comment { body }
      }
      ... on PullRequestNotification {
        pullRequest { title number url }
      }
      ... on DocumentNotification {
        documentId
      }
    }
  }
}
' | jq '[.data.notifications.nodes[] | select(.readAt == null)]'

Bump first and use the after cursor for pagination if you have more than 50 notifications.

[simon-aira]

That works perfect! Exactly what I needed. Thank you so much for taking it all the way!