defaultheader

GET activity

Get data of one activity object.

Parameters

Parameters Detail
format
optional
Specifies returned data format
Accepted value: "json", "xml"

Resource Information

Authentication: See Access Permission for GET activity

HTTP Methods: GET

Request URL Format: https://{api_domain}/api3/activity/{id}

Access Permission

Access to data varies base on system setting and requester roles. See Authentication for detail on authentication.

Private WebStorms: Requester must authenticate to get data.

Public WebStorms: No authentication required to get data.

Errors

  • Invalid object ID or you don't have access to this object

Example Request

  • Method: GET
  • Header: Authorization=Bearer 85f7b2462570acdde9a458ba6495b8763dcd040c
  • URL: https://example.brightidea.com/api3/activity/D2136C62-B65E-40D2-ABD2-873AEF120514

    {
        "activity": {
            "type": "POST_IDEA",
            "id": "D2136C62-B65E-40D2-ABD2-873AEF120514",
            "date_created": "2013-04-18 12:16:41.720",
            "idea_id": "0D7C82A2-4B20-42C1-A54C-9608FFF55CDA",
            "campaign_id": "0A140858-AD8A-4F97-9926-D80AD156A130",
            "campaign_name": "Sample Campaign",
            "idea_title": "Here is a great Idea Title",
            "category_name": "Category 4",
            "anonymous": false,
            "team_submission": true,
            "member": {
                "id": "B471BFED-BCC2-49CC-A917-5F09AA73EEB3",
                "email": "mpower@example.com",
                "screen_name": "Max Power",
                "first_name": "Max",
                "last_name": "Power",
                "job_title": "Safety Inspector",
                "address": "742 Evergreen Terrace Springfield IL",
                "phone": "123456-7890",
                "mobile_phone": "987654-3210",
                "external_user_id": "0072",
                "skills": "Boxer, Mascot, Astronaut, Baby proofer, Truck driver, Hippie, Plow Driver, Food Critic",
                "work_history": "Conceptual Artist, Mayor, Country Western Manager, Garbage Commissioner, Mountain Climber",
                "photo_url": null,
                "date_created": "2013-04-18 11:27:48.537",
                "date_modified": null,
                "active": true
            }
        }
    }
    




LIST activity

Get data on a list of activity objects. Objects are order by created date descending by default.

On retrieving large set of data, requester should use pagination parameters such as page and page_size to manage multiple requests.

Parameters

Parameters Detail
id
optional
Filter return by activity ID
Sample value: "11111111-1111-1111-1111-111111111111"
date_created
optional
Filter return by activity created date. Response contains all data created within the 24 hours of the specified date
Sample value: "12/06/2009"
type
optional
Filter return by activity by type.
Accepted Value: "POST_IDEA", "POST_BLOG", "PROMOTE_IDEA", "DEMOTE_IDEA", "POST_COMMENT", "POST_BLOG_COMMENT", "REGISTER", "UPDATE_PROFILE", "MY_IDEAS_STATUS_UPDATED", "POST_UPDATE", "POST_ON_WALL"
campaign_id
optional
Filter return by ID of a campaign
Sample value: "11111111-1111-1111-1111-111111111111"
following
optional
Filter return by members the requester is following. Same result as member landing page.
Accepted value: 1
page_size
optional
Specifies number of records returns per page. Default: 20. Minimum: 1. Maximum: 100
Sample value: 50
page
optional
Specifies which page of records to return. Default: 1. Minimum: 1. Maximum: {page_count}
Sample value: 5
order
optional
A SQL style string that specifies the order the records should return in.
Sample value: "date_created ASC".
Accepted attributes: "id", "date_created"
format
optional
Specifies returned data format
Accepted value: "json", "xml"

Resource Information

Authentication: See Access Permission for LIST activity

HTTP Methods: GET

Request URL Format: https://{api_domain}/api3/activity

Access Permission

Access to data varies base on system setting and requester roles. See Authentication for detail on authentication.

Private WebStorms: Requester must authenticate to get data.

Public WebStorms: No authentication required to get data.

Errors

  • Invalid object ID or you don't have access to this object

Example Request

  • Method: GET
  • Header: Authorization=Bearer 85f7b2462570acdde9a458ba6495b8763dcd040c
  • URL: https://example.brightidea.com/api3/activity?page_size=2&page=1&type=POST_UPDATE

    {
        "activity_list": [
            {
                "type": "POST_UPDATE",
                "id": "FB4CAD9D-0169-48C8-9553-CD3D30D1B052",
                "date_created": "2013-04-18 14:51:41.287",
                "update_id": "9B061C43-4E80-498C-B41E-4482C21632F7",
                "text": "Test Update to be commented and hifive on",
                "hifive": [
                    {
                        "id": "67712BA4-D8FF-48FE-902D-60C734075BE9",
                        "date_created": "2013-04-18 14:53:06.967",
                        "update_id": "9B061C43-4E80-498C-B41E-4482C21632F7",
                        "member": {
                            "id": "B471BFED-BCC2-49CC-A917-5F09AA73EEB3",
                            "email": "mpower@example.com",
                            "screen_name": "Max Power",
                            "first_name": "Max",
                            "last_name": "Power",
                            "job_title": "Safety Inspector",
                            "address": "742 Evergreen Terrace Springfield IL",
                            "phone": "123456-7890",
                            "mobile_phone": "987654-3210",
                            "skills": "Boxer, Mascot, Astronaut, Baby proofer, Truck driver, Hippie, Plow Driver, Food Critic",
                            "work_history": "Conceptual Artist, Mayor, Country Western Manager, Garbage Commissioner, Mountain Climber",
                            "photo_url": null,
                            "date_created": "2013-04-18 11:27:48.537",
                            "date_modified": null
                        }
                    }
                ],
                "comments": [
                    {
                        "id": "9D4C13A3-BBA7-43D9-A450-24C66816511B",
                        "comment": "Here is my comment",
                        "date_created": "2013-04-18 14:51:53.783",
                        "update_id": "9B061C43-4E80-498C-B41E-4482C21632F7",
                        "member": {
                            "id": "866144B1-E302-42EF-AF80-75DE988885AE",
                            "email": "jdoe@example.com",
                            "screen_name": "John Doe",
                            "first_name": "John",
                            "last_name": "Doe",
                            "job_title": "Sales",
                            "address": "123 fake street",
                            "phone": "123 456-789",
                            "mobile_phone": "987 654-3210",
                            "external_user_id": null,
                            "skills": "Selling Software",
                            "work_history": "Worked at sales.com",
                            "photo_url": "",
                            "date_created": "2013-03-07 19:09:54.563",
                            "date_modified": "2013-04-18 13:14:21.067",
                            "active": true,
                            "photo_file_id": "02F11D0E-BA74-4A7D-B1BE-4F7F651B2507"
                        }
                    }
                ],
                "member": {
                    "id": "8FA49B96-3693-4282-8919-014618D7B3B8",
                    "screen_name": "Lillian Smith",
                    "first_name": "Lillian",
                    "last_name": "Smith",
                    "job_title": "",
                    "address": "",
                    "phone": "",
                    "mobile_phone": "",
                    "external_user_id": null,
                    "skills": "",
                    "work_history": "",
                    "photo_url": "",
                    "date_created": "2013-03-07 17:10:13.627",
                    "date_modified": "2013-04-16 15:42:16.430"
                }
            },
            {
                "type": "POST_UPDATE",
                "id": "3326811E-5E09-4196-B8AF-FCADE3798173",
                "date_created": "2013-04-18 11:30:52.930",
                "update_id": "4317828E-6D09-4234-AA62-50322BBB2EEA",
                "text": "Test update post 2 - with image",
                "attachment": {
                    "id": "0BB62224-E6C8-4ED7-8F02-EE1371CCD883",
                    "reference_id": "4317828E-6D09-4234-AA62-50322BBB2EEA",
                    "extension": "jpg",
                    "original_filename": "apple.jpg",
                    "grouping": "Update Photo",
                    "url": "https://example.brightideatest.com/api3/file/0BB62224-E6C8-4ED7-8F02-EE1371CCD883?format=binary",
                    "type": "image/jpeg"
                },
                "member": {
                    "id": "8FA49B96-3693-4282-8919-014618D7B3B8",
                    "screen_name": "Lillian Smith",
                    "first_name": "Lillian",
                    "last_name": "Smith",
                    "job_title": "",
                    "address": "",
                    "phone": "",
                    "mobile_phone": "",
                    "skills": "",
                    "work_history": "",
                    "photo_url": "",
                    "date_created": "2013-03-07 17:10:13.627",
                    "date_modified": "2013-04-16 15:42:16.430"
                }
            }
        ],
        "stats": {
            "total": "5",
            "page_count": 3,
            "current_page": 1
        }
    }
    

FAQ

Question: LIST activity only return 100 objects maximum per request. How do I retrieve more results.

Answer: LIST activity response is automatically paginated. You can specify which page of the result a request should return. For example, if you requested for 100 idea objects in the initial request, pass "page_size=100&page=2" to get the next 100. page_count is returned with every LIST request so your application can figure out when it hits the end.

Question: How do I create an update so it will show, or delete an update so it will be removed from the activity feed?

Answer: Use GET update API functions to create or delete updates. You can also comment and hifive on an update as well.