v1

latestOpenAPI 3.0.0Apache 2.02026-07-2410185524.2 KB
Segments

get all

Returns a list of segments you've previously created. The segments will be returned in descending order of when they were created, unless you specify otherwise.

For custom components:

RaiselyComponents.api.all('segments').get(params = {}, headers = {}) => Promise<{result}>

:fa-gears: See Restie Response Data for a more detailed overview of responses through the client wrapper

get/segments

Query parameters

privateboolean

Returns the full record when authenticated

qstring

Search query to find records matching

limitnumber

The number of records to limit per page

offsetnumber

The pagination offset (in number of records)

sortstring

The record attribute to filter on (use in conjunction with order)

order'asc' | 'desc'

The direction to sort (only applied if sort is also provided) * asc - Ascending * desc - Descending

isSharedboolean

Filter Segment based on their isShared value

isTemporaryboolean

Filter Segment based on their isTemporary value

organisationstring

Filter by organisation uuid

userstring

Filter by user uuid

Headers

Authorizationstring

A valid HTTP Bearer token, required to access private records.

Response

The resulting collection of Segment records

Example response

{
  "data": [
    {
      "createdAt": "2020-12-03T06:52:46.330Z",
      "isShared": true,
      "isTemporary": true,
      "label": "My Segment",
      "path": "example-path",
      "rules": {
        "match": "all"
      },
      "updatedAt": "2020-12-03T06:52:46.330Z",
      "uuid": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
    }
  ],
  "pagination": {
    "total": 10,
    "pages": 2,
    "offset": 5,
    "limit": 5
  }
}