Activity Streams

This information is for developers who want to interact programmatically with Atlassian activity streams. The documentation applies to Activity Streams 4 and later. Please refer to the version matrix to see which version of Activity Streams is bundled with each product.

What are Activity Streams?

An activity stream is a list of events, displayed to a user in an attractive and interactive interface. They are usually recent activities by the current user and other people using the same social site(s) or system(s).

An example is the Activity Stream gadget used on Jira dashboards.

Coding with Activity Streams

These are the ways you can interact with Activity Streams in Atlassian products.

Consuming an Activity Streams Feed

Activity Streams generates feeds of activity items from Atlassian application events and other sources. For example, the default Activity Streams feed contains Bamboo build results, Crucible review comments and more. If you wish to consume an activity stream from an Atlassian application, read on.

Making Pluggable Inline Actions for an Activity Stream

Activity streams funnel lots of information into an easily accessible view, so that people can easily keep track of what's happening. The next step is to allow people to act on the items they see, right there on the stream itself. As a plugin developer, you can use the Atlassian Activity Streams API to add your own inline actions whenever you please. More...

Adding Activities to a Third Party Feed

Activity Streams includes a lightweight API that allows plugins to add activities to the activity stream in an Atlassian application. This API doesn't give you as much power as building a fully-fledged activity streams provider (described below), but it's extremely easy to use. See how to add activities to a third party feed using the Java API or the REST API.

Making your own Activity Streams Provider

An activity stream is created from the input of 'providers' that create sets of items for inclusion in the stream. You can create your own external provider and inject custom events into the activity streams. See how to build a provider plugin.