Skip to main content
POST
/
v1
/
stories
/
embed
/
auth
Create an embed token (Dashboard)
curl --request POST \
  --url https://api.domo.com/v1/stories/embed/auth \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sessionLength": 1440,
  "authorizations": [
    {
      "token": "bc36f",
      "permissions": [
        "READ",
        "FILTER",
        "EXPORT"
      ],
      "filters": [
        {
          "column": "State",
          "operator": "IN",
          "values": [
            "California",
            "New York",
            "Ohio"
          ]
        }
      ]
    }
  ]
}
'
{
  "authentication": "thisisafakeauthenticationhbGciOiJIUzI1NiJ9.eyJzdWIiOiI0MDAxOTY1NCIsIm5iZiI6MTU3OTY0NjE2NCwiaXNzIjoiYXB2F0ZXdheSIsImVtYiI6WyJ7XCJ0b2tlblwiOlwiYnFvN2VcIixcImxpbmtUeXBlXCI6XCJTRUFSQ0hBQkxFXCIsXCJwZXJtaXNzaW9uc1wiOltcIlJFQURcIl19Il0sII6MTU3OTY3NDk3NCwiaWF0Ir5h3joxNTc5NjQ2MTc0LCJqdGkiOiI3MTBwODRmMy094n2S3FmLTRjZWUtYTczZC00ZmNjMWU4OTViZmQifQ.ET0s7o49vLvj2MUwOALfayR7_vzEIMn5TRoTjq3TPo"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Sample Filter Objects

Filter by column "Count" for values that are greater than the value 5.

[{"column": "Count", "operator": "GREATER_THAN", "values": ["4"]}]

Filter by column "Date" for values between the following dates: "2020-01-15" and "2020-01-21".

[{"column":"Date","operand":"BETWEEN","values":["2020-01-15","2020-01-21"]}]

Filter by column "State" for values that are one of the following: "California", "New York", or "Ohio".

[{"column":"State","operand":"IN","values":["California", "New York", "Ohio"]}]
​
authorizations
object[]
required

A list of embed authorization objects

​
sessionLength
integer

The amount of minutes the session will be valid for. If a value is not specified here and a customer has specified a customer session idle length, then that number will be used instead. If a customer has not specified a session idle length, then a default value of 8 hours is used. The value specified here in the api cannot be greater than the customer sessions idle length if one has been set or if one hasn't been set, the value cannot be greater than the default value of 8 hours.

Response

200 - application/json

Returns a DataSet object when successful. The returned object will have DataSet attributes based on the information that was provided when DataSet was created from the Stream created.

​
authentication
string