Activity Feeds V3 is in closed alpha — do not use it in production (just yet).

Pins

Overview

Sometimes you’ll want to pin your favorite activity to a feed. You can pin an activity like this:

let activity = client.activity(
    for: "activity_123",
    in: FeedId(group: "user", id: "john")
)
// Pin an activity
try await activity.pin()

// Unpin an activity
try await activity.unpin()

val activity = client.activity(
    activityId = "activity_123",
    fid = FeedId(group = "user", id = "john")
)
// Pin an activity
activity.pin()

// Unpin an activity
activity.unpin()

// Pin an activity
client.pinActivity({
  feed_group_id: feed.group,
  feed_id: feed.id,
  activity_id: "activity_123",
});

// Unpin an activity
client.unpinActivity({
  feed_group_id: feed.group,
  feed_id: feed.id,
  activity_id: "activity_123",
});

// Pin an activity
client.feeds.pinActivity({
  feed_group_id: feed.group,
  feed_id: feed.id,
  activity_id: "activity_123",
  user_id: "<user id>",
});

// Unpin an activity
client.feeds.unpinActivity({
  feed_group_id: feed.group,
  feed_id: feed.id,
  activity_id: "activity_123",
  user_id: "<user id>",
});

package main

import (
    "context"
    "log"

    "github.com/GetStream/getstream-go/v3"
)

func main() {
    client, err := getstream.NewClient("<your_api_key>", "<your_api_secret>")
    if err != nil {
        log.Fatal(err)
    }

    ctx := context.Background()

    feedsClient := client.Feeds()

    // Get the feed
    feed := feedsClient.Feed("user", "john")

    // Pin an activity
    pinResponse, err := feed.PinActivity(ctx, "activity_123", &getstream.PinActivityRequest{})
    if err != nil {
        log.Fatal(err)
    }
    log.Printf("Activity pinned: %+v", pinResponse.Data)

    // Unpin an activity
    unpinResponse, err := feed.UnpinActivity(ctx, "activity_123", &getstream.UnpinActivityRequest{})
    if err != nil {
        log.Fatal(err)
    }
    log.Printf("Activity unpinned: %+v", unpinResponse.Data)
}

When you read a feed pinned activities are automatically returned:

try await feed.getOrCreate()
print(feed.state.pinnedActivities)

feed.getOrCreate()
feed.state.pinnedActivities.collect { pinData ->
    println(pinData)
}

const response = await feed.getOrCreate();
console.log(response.pinned_activities);

const response = await feed.getOrCreate({ user_id: "sara" });
console.log(response.pinned_activities);

Comments

State Layer