Retrieve Multiple Activities

Returns an array of activity objects, along with trackable and user objects. Can be filtered on date ranges and is paged.

https://api.storyblok.com/v2/cdn/spaces/:space_id/activities/

Path Parameters

:space_id
required number

Numeric ID of a space

Query Parameters

created_at_gte
string

Activity creation date is greater than YYYY-MM-DD
created_at_lte
string

Activity creation date is lower than YYYY-MM-DD
by_owner_ids
string

Filter activities by owner IDs (Comma separated)

types

enum

Filter activities by specific (multiple) activity types. (Comma separated)

Type	Explanation
Component	Filter activities related to components
Story	Filter activities related to stories
Workflow	Filter activities related to workflows
WorkflowStage	Filter activities related to workflow stages
WorkflowStageChange	Filter activities related to workflow stage changes
Space	Filter activities related to space changes
Discussion	Filter activities related to discussions
Collaborator	Filter activities related to change in collaborator objects
Comment	Filter activities related to comments
SpaceRole	Filter activities related to space roles
Release	Filter activities related to releases
Branch	Filter activities related to piplelines
Asset	Filter activities related to assets
AssetFolder	Filter activities related to asset folders
Approval	Filter activities related to approvals
Taggy	Filter activities related to tags
Datasource	Filter activities related to datadources
DatasourceEntry	Filter activities related to datasource entries
ScheduledContent	Filter activities related to content scheduling
Preset	Filter activities related to presets

Response Properties

activities
object[]

An array of activity objects along with trackables and user objects.
- activity
  The Activity Object
  
  The Activity Object
  - id
    number
    
    The numeric ID of the activity
  - trackable_id
    number
    
    Id of reference object that was changed
  - trackable_type
    object
    
    Type of the referenced object
  - owner_id
    number
    
    ID of the user that changed made the activity
  - owner_type
    string
    
    Default: "User"
  - key
    object
    
    Key defined by type.action (eg: story.create, story.update, component.create)
  - parameters
    object
    
    Additional parameter passed; Default: null
  - recipient_id
    number
    
    Default: null
  - recipient_type
    string
    
    Default: null
  - created_at
    string
    
    Creation date (Format: yyyy-MM-dd'T'HH:mm:ssZ)
  - updated_at
    string
    
    Latest update date (Format: yyyy-MM-dd'T'HH:mm:ssZ)
  - space_id
    number
    
    Numeric ID of a space
- trackable
  object
  
  Object containing details about the changed object
  
  The trackable object contains more information while retrieving a single activity
- user
  object
  
  The user object
  - id
    number
    
    The numeric user ID
  - userid
    string
    
    User ID of collaborator
  - friendly_name
    string
    
    Friendly name of collaborator
  - active
    boolean
    
    True if the user is active

Select a Language

Example Request

Request

curl "https://mapi.storyblok.com/v1/spaces/606/activities/?created_at_gte=2018-12-14&created_at_lte=2018-12-18" \
  -X GET \
  -H "Authorization: YOUR_OAUTH_TOKEN" \
  -H "Content-Type: application/json"

Request

// Using the Universal JavaScript Client:
// https://github.com/storyblok/storyblok-js-client
Storyblok.get('/spaces/606/activities/', {
  "created_at_gte": "2018-12-14",
  "created_at_lte": "2018-12-18"
})
  .then(response => {
    console.log(response)
  }).catch(error => { 
    console.log(error)
  })

Request

$client = new \Storyblok\ManagementClient('YOUR_OAUTH_TOKEN');

$client->get('/spaces/606/activities/', [
  "created_at_gte" =>  "2018-12-14",
  "created_at_lte" =>  "2018-12-18"
])->getBody();

Request

require 'storyblok'
client = Storyblok::Client.new(oauth_token: 'YOUR_OAUTH_TOKEN')

client.false('/spaces/606/activities/', {:params => {
  "created_at_gte" =>  "2018-12-14",
  "created_at_lte" =>  "2018-12-18"
}})

Request

HttpResponse<String> response = Unirest.get("https://mapi.storyblok.com/v1/spaces/606/activities/?created_at_gte=2018-12-14&created_at_lte=2018-12-18")
  .header("Authorization", "YOUR_OAUTH_TOKEN")
  .asString();

Request

var client = new RestClient("https://mapi.storyblok.com/v1/spaces/606/activities/?created_at_gte=2018-12-14&created_at_lte=2018-12-18");
var request = new RestRequest(Method.GET);

request.AddHeader("Authorization", "YOUR_OAUTH_TOKEN");
IRestResponse response = client.Execute(request);

Request

import Foundation

let headers = [
  "Content-Type": "application/json",
  "Authorization": "YOUR_OAUTH_TOKEN"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://mapi.storyblok.com/v1/spaces/606/activities/?created_at_gte=2018-12-14&created_at_lte=2018-12-18")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0)
request.method = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

Request

import requests

url = "https://mapi.storyblok.com/v1/spaces/606/activities/"

querystring = {"created_at_gte":"2018-12-14","created_at_lte":"2018-12-18"}

payload = ""
headers = {
  'Content-Type': "application/json",
  'Authorization': "YOUR_OAUTH_TOKEN"
}

response = requests.request("GET", url, data=payload, headers=headers, params=querystring)

print(response.text)

You will receive an array of activity objects as a response.

Prev Retrieve a Single Activity

Next Introduction