Skip to main content
  • First step URL (on the right page) - required
  • Segmentation matches (User is the right person) - required but can be to match All Users
  • Element appears on the page - optional
  • Element must be clicked on or hovered over - optional
  • etc.
To know more about Tours, you can visit our product documentation.
With the Chameleon API for Tours, you can:
  • List all the existing Tours according to the indicated parameters.
  • Retrieve a single Tour.

​
Schema

PropertyTypeDescription
idIDThe Chameleon ID
created_attimestampWhen this happened or when this was added to the Database
updated_attimestampThe last time any property was updated
archived_attimestampThe time when this was archived
namestringThe name given by an administrator of Chameleon
stylestringThe delivery method of this Tour: One of auto or manual
positionnumberThe order that these appear in lists (starting from 0)
tour_link_urlstringWhen style=manual this URL is loaded to start the Tour
experiment_attimestampWhen Experimentation was turned on.
experiment_rangestringThe range of Profile#percent that will be included in the experiment
segment_idIDThe Chameleon ID of the configured Segment
published_attimestampThe time this was most recently published
tag_idsarray<ID>The Chameleon IDs of the Tags attached to this model
rate_unlimit_attimestampThis item is excluded from Rate limiting
statsobjectAggregated statistics for this model (all-time)
stats.started_countnumberNumber of your end-users who saw this
stats.last_started_attimestampMost recent time any user saw this
stats.completed_countnumberNumber of your end-users who completed/finished this
stats.last_completed_attimestampMost recent time any user completed/finished this
stats.exited_countnumberNumber of your end-users who dismissed/exited this
stats.last_exited_attimestampMost recent time any user dismissed/exited this

​
List Tours

List all the Tours that follow the specified parameters.

​
HTTP Request

GET https://api.chameleon.io/v3/edit/tours
param-description
limitoptionalDefaults to 50 with a maximum of 500
beforeoptionalUsed when paginating, use directly from the cursor object from the previous response
beforeoptionalRead as “created before” and can be given as a timestamp to get only limit items that were created before this time
afteroptionalRead as “created after” and can be given as a timestamp or ID to get only limit items that were created after this time

​
HTTP Response

{
  "tours": [
    {
      "id": "5f3c4232c712de665632a6d5",
      "name": "Revamped Dashboard Launch",
      "style": "auto",
      "position": 4,
      "published_at": "2029-04-07T12:18:00Z",
       ...
    },
    {
      "id": "5f3c4232c712de665632a2a1",
      "name": "Growth plan upsell banner 2029-02",
      "style": "auto",
      "position": 3,
      "published_at": "2029-04-07T12:18:00Z",
       ...
    },
    ...
  ],
  "cursor": {
    "limit": 50,
    "before": "5f3c4232c712de665632a2a1"
  }
}

​
Update a Tour

Update a single Tour to change the Environments or to Publish it.

​
HTTP Request

PATCH https://api.chameleon.io/v3/edit/tours/:id
param-description
idrequiredA Tour ID to update
url_group_idoptionalAn Environment ID prefixed with + to add or or - to remove the Environment
tag_idoptionalA Tag ID prefixed with + to add or or - to remove the Tag
published_atoptionalThe published time of this Tour (set to now to trigger a publish)
To Publish the Tour send the current timestamp in iso8601 format 
{
  "published_at": "2029-04-07T12:18:00Z"
}
To Unpublish the Tour set the published_at to null 
{
  "published_at": null
}
To add the 5e3c4232c712de666d55632a Environment use a + prefix 
{
  "url_group_id": "+5e3c4232c712de666d55632a"
}
To remove the 5e3c4232c712de666d55632a Environment use a - prefix 
{
  "url_group_id": "-5e3c4232c712de666d55632a"
}

​
Filtering by Segment

See Listing Related models

​
Retrieve a Tour

Retrieve a single Tour.

​
HTTP Request

GET https://api.chameleon.io/v3/edit/tours/:id
param-description
idrequiredA Tour ID to lookup
{
  "tour": {
    "id": "5f3c4232c712de665632a2a1",
    "name": "Growth plan upsell banner 2029-02",
    "style": "auto",
    "position": 3,
    "published_at": "2029-04-07T12:18:00Z",
    ...
  }
}