Skip to main content

DevCycle Bucketing API (1.0.0)

Download OpenAPI specification:Download

Documents the DevCycle Bucketing API which provides and API interface to User Bucketing and for generated SDKs.

Authentication

bearerAuth

Enter your DevCycle SDK token

Security Scheme Type API Key
Header parameter name: Authorization

devcycle

Get variable by key for user data

Authorizations:
path Parameters
key
required
string

Variable key

Request Body schema: application/json
user_id
required
string

Unique id to identify the user

email
string

User's email used to identify the user on the dashboard / target audiences

name
string

User's name used to identify the user on the dashboard / target audiences

language
string <= 2 characters

User's language in ISO 639-1 format

country
string <= 2 characters

User's country in ISO 3166 alpha-2 format

appVersion
string

App Version of the running application

appBuild
string

App Build number of the running application

customData
object

User's custom data to target the user with, data will be logged to DevCycle for use in dashboard.

privateCustomData
object

User's custom data to target the user with, data will not be logged to DevCycle only used for feature bucketing.

createdDate
number

Date the user was created, Unix epoch timestamp format

lastSeenDate
number

Date the user was created, Unix epoch timestamp format

platform
string

Platform the Client SDK is running on

platformVersion
string

Version of the platform the Client SDK is running on

deviceModel
string

User's device model

sdkType
string
Enum: "api" "server"

DevCycle SDK type

sdkVersion
string

DevCycle SDK Version

Responses

Request samples

Content type
application/json
{
  • "user_id": "string",
  • "email": "string",
  • "name": "string",
  • "language": "st",
  • "country": "st",
  • "appVersion": "string",
  • "appBuild": "string",
  • "customData": { },
  • "privateCustomData": { },
  • "createdDate": 0,
  • "lastSeenDate": 0,
  • "platform": "string",
  • "platformVersion": "string",
  • "deviceModel": "string",
  • "sdkType": "api",
  • "sdkVersion": "string"
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "key": "string",
  • "type": "String",
  • "value": { }
}

Get all variables by key for user data

Authorizations:
Request Body schema: application/json
user_id
required
string

Unique id to identify the user

email
string

User's email used to identify the user on the dashboard / target audiences

name
string

User's name used to identify the user on the dashboard / target audiences

language
string <= 2 characters

User's language in ISO 639-1 format

country
string <= 2 characters

User's country in ISO 3166 alpha-2 format

appVersion
string

App Version of the running application

appBuild
string

App Build number of the running application

customData
object

User's custom data to target the user with, data will be logged to DevCycle for use in dashboard.

privateCustomData
object

User's custom data to target the user with, data will not be logged to DevCycle only used for feature bucketing.

createdDate
number

Date the user was created, Unix epoch timestamp format

lastSeenDate
number

Date the user was created, Unix epoch timestamp format

platform
string

Platform the Client SDK is running on

platformVersion
string

Version of the platform the Client SDK is running on

deviceModel
string

User's device model

sdkType
string
Enum: "api" "server"

DevCycle SDK type

sdkVersion
string

DevCycle SDK Version

Responses

Request samples

Content type
application/json
{
  • "user_id": "string",
  • "email": "string",
  • "name": "string",
  • "language": "st",
  • "country": "st",
  • "appVersion": "string",
  • "appBuild": "string",
  • "customData": { },
  • "privateCustomData": { },
  • "createdDate": 0,
  • "lastSeenDate": 0,
  • "platform": "string",
  • "platformVersion": "string",
  • "deviceModel": "string",
  • "sdkType": "api",
  • "sdkVersion": "string"
}

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Get all features by key for user data

Authorizations:
Request Body schema: application/json
user_id
required
string

Unique id to identify the user

email
string

User's email used to identify the user on the dashboard / target audiences

name
string

User's name used to identify the user on the dashboard / target audiences

language
string <= 2 characters

User's language in ISO 639-1 format

country
string <= 2 characters

User's country in ISO 3166 alpha-2 format

appVersion
string

App Version of the running application

appBuild
string

App Build number of the running application

customData
object

User's custom data to target the user with, data will be logged to DevCycle for use in dashboard.

privateCustomData
object

User's custom data to target the user with, data will not be logged to DevCycle only used for feature bucketing.

createdDate
number

Date the user was created, Unix epoch timestamp format

lastSeenDate
number

Date the user was created, Unix epoch timestamp format

platform
string

Platform the Client SDK is running on

platformVersion
string

Version of the platform the Client SDK is running on

deviceModel
string

User's device model

sdkType
string
Enum: "api" "server"

DevCycle SDK type

sdkVersion
string

DevCycle SDK Version

Responses

Request samples

Content type
application/json
{
  • "user_id": "string",
  • "email": "string",
  • "name": "string",
  • "language": "st",
  • "country": "st",
  • "appVersion": "string",
  • "appBuild": "string",
  • "customData": { },
  • "privateCustomData": { },
  • "createdDate": 0,
  • "lastSeenDate": 0,
  • "platform": "string",
  • "platformVersion": "string",
  • "deviceModel": "string",
  • "sdkType": "api",
  • "sdkVersion": "string"
}

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Post events to DevCycle for user

Authorizations:
Request Body schema: application/json
Array of objects (Event) [ items ]
object (UserData)

Responses

Request samples

Content type
application/json
{
  • "event": [
    ],
  • "user": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string"
}