Story Data API

Use the Datagram API to provide beautiful data easily to your audience with a simple API and the Datagram App. Send actionable information directly to the mobile phone of your users.

Getting started

This guide will get you all set up and ready to use the Datagram API. We'll cover how to get started using one of our API clients and how to make your API requests. We'll also look at where to go next to find all the information you need to take full advantage of our powerful REST API.

Authentication

To authenticate requests to the Datagram API, you need to use your personal access token. This token must be included in the request headers to successfully authenticate and interact with the API.

Authentication Header

PATCH /api/stories/:STORY_ID/data HTTP/1.1
Host: https://api.datagram.live
Authorization: token :ACCESS_TOKEN

Always keep your token safe and avoid committing it to public packages/repositories. The best place to store your token is an environment variable or any other secure storage.

Making your API request

Below, you can see how to update your story data by sending a PATCH request to the API endpoint.

PATCH

/api/stories/:STORY_ID/data

curl -X PATCH https://api.datagram.live/api/stories/:STORY_ID/data \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: token :ACCESS_TOKEN" \
  -d '{}'