The project is in a healthy, maintained state
This gem helps you build custom activities for Orbit workspaces using the Orbit API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
 Dependencies

Development

>= 0
~> 3.4
~> 1.7
~> 3.12

Runtime

~> 4.4
~> 2.5
~> 13.0
~> 2.4
 Project Readme

Orbit Activities Helper Library for Ruby

Build Status Gem Version Contributor Covenant

Orbit API helper library for Ruby.
This client can create, read, update and delete activities in your Orbit workspace.

Orbit

Package Usage

Installation

To install this integration in a standalone app, add the gem to your Gemfile:

gem "orbit_activities"

Then, run bundle install from your terminal.

Usage

Create an Activity

To create an activity:

OrbitActivities::Request.new(
    api_key: # Your Orbit API key,
    workspace_id: # Your Orbit workspace ID,
    action: "new_activity",
    body: # The custom activity object in JSON format, see Orbit API docs for reference
)

You can inspect the Orbit API response by appending .response to the end of the initialization method.

Update an Activity

To update an activity:

OrbitActivities::Request.new(
    api_key: # Your Orbit API key,
    workspace_id: # Your Orbit workspace ID,
    action: "update_activity",
    activity_id: # The ID of the activity to be updated,
    member_id: # The ID of the member the activity is attached to,
    body: # The custom activity object in JSON format, see Orbit API docs for reference
)

You can inspect the Orbit API response by appending .response to the end of the initialization method.

Delete an Activity

To delete an activity:

OrbitActivities::Request.new(
    api_key: # Your Orbit API key,
    workspace_id: # Your Orbit workspace ID,
    action: "delete_activity",
    activity_id: # The ID of the activity to be updated,
    member_id: # The ID of the member the activity is attached to
)

You can inspect the Orbit API response by appending .response to the end of the initialization method.

List Activities

To list activities:

OrbitActivities::Request.new(
    api_key: # Your Orbit API key,
    workspace_id: # Your Orbit workspace ID,
    action: "list_activities",
    filters: # Any filters on the request in JSON format, see Orbit API docs for reference
).response

Get Specific Activity

To get a specific activity:

OrbitActivities::Request.new(
    api_key: # Your Orbit API key,
    workspace_id: # Your Orbit workspace ID,
    action: "get_activity",
    activity_id: # The ID of the actiivity
).response

Get Member Activities

To get activities associated with a specific member:

OrbitActivities::Request.new(
    api_key: # Your Orbit API key,
    workspace_id: # Your Orbit workspace ID,
    action: "list_member_activities",
    activity_id: # The ID of the actiivity,
    member_id: # The ID of the member,
    filters: # Any filters on the request in JSON format, see Orbit API docs for reference
).response

Get Latest Activity Timestamp for Activity Type

To get the latest activity timestamp for a specific activity type:

OrbitActivities::Request.new(
    api_key: # Your Orbit API key,
    workspace_id: # Your Orbit workspace ID,
    action: "latest_activity_timestamp",
    filters: { activity_type: # Activity type to search for, e.g. "custom:linkedin:comment" }
).response

For details on the data structures the Orbit API expects, refer to the Orbit API Documentation.

Contributing

We 💜 contributions from everyone! Check out the Contributing Guidelines for more information.

License

This is available as open source under the terms of the MIT License.

Code of Conduct

This project uses the Contributor Code of Conduct. We ask everyone to please adhere by its guidelines.