Timelines Elements

All Timeline Elements

You can get a list of all the element effects of a timeline by using the following endpoint.

{warning} Don't forget that all endpoints documented here need to be prefixed with 1.0/campaigns/{campaign.id}/.

Method URI Headers
GET/HEAD timelines/{timeline.id}/timeline_elements Default

Results

{
    "data": [
        {
            "id": 1,
            "timeline_id": 1,
            "era_id": 1,
            "name": "Kemali Uprising",
            "entity_id": 56,
            "entry": "...",
            "entry_parsed": "...",
            "date": "3rd of Appen 114",
            "colour": "blue",
            "position": 1,
            "visibilility_id": 1,
            "created_by": 1,
            "created_at": "2020-08-05 14:32:59",
            "updated_at": "2020-08-05 14:33:22"
        }
    ],
    "links": {
        "first": "https://api.kanka.io/1.0/campaigns/1/timelines/1/timeline_elements?page=1",
        "last": "https://api.kanka.io/1.0/campaigns/1/timelines/1/timeline_elements?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.kanka.io/1.0/campaigns/1/timelines/1/timeline_elements",
        "per_page": 15,
        "to": 1,
        "total": 1
    }
}

Timeline Element

To get the details of a single element effect, use the following endpoint.

Method URI Headers
GET/HEAD timelines/{timeline.id}/timeline_elements/{timeline_element.id} Default

Results

{
    "data": {
        "id": 1,
        "timeline_id": 1,
        "era_id": 1,
        "name": "Kemali Uprising",
        "entity_id": 56,
        "entry": "...",
        "entry_parsed": "...",
        "date": "3rd of Appen 114",
        "colour": "blue",
        "position": 1,
        "visibilility_id": 1,
        "created_by": 1,
        "created_at": "2020-08-05 14:32:59",
        "updated_at": "2020-08-05 14:33:22"
    }

}

Create a Timeline Element

To create a timeline element, use the following endpoint.

Method URI Headers
POST timelines/{timeline.id}/timeline_elements Default

Body

Parameter Type Detail
name string (Required if no entity) Name of the element
entity_id int (Required if no name) Entity ID
era_id int (Required) Timeline Era ID
entry string Entry of the element
date string Date of the element
colour string Colour of the element
position int Position in the list of elements of the era
visibility_id int The visibility ID: 1 for all, 2 self, 3 admin, 4 self-admin or 5 members.

Results

{success} Code 200 with JSON body of the new timeline element.

Update a Timeline Element

To update a timeline, use the following endpoint.

Method URI Headers
PUT/PATCH timelines/{timeline.id}/timeline_elements/{timeline_element.id} Default

Body

The same body parameters are available as for when creating a timeline element.

Results

{success} Code 200 with JSON body of the updated timeline element.

Delete a Timeline Element

To delete a timeline element, use the following endpoint.

Method URI Headers
DELETE timelines/{timeline.id}/timeline_elements/{timeline_element.id} Default

Results

{success} Code 200 with JSON.