Key Accounts
Key Accounts Documentation
Key Account [LIST]
Key Account [LIST]
Request
Endpoint
GET /api/v2/user/key_accounts
Content-Type: application/vnd.api+jsonBody
Response
Headers
Content-Type: application/vnd.api+json; charset=utf-8
200 OKBody
{
"data": [
{
"id": "54ecd774-ac41-4026-a103-03893eedeb53",
"type": "key_accounts",
"attributes": {
"created_at": "2021-11-23T14:37:45Z",
"email": "[email protected]",
"first_name": "Maryanna",
"last_download": null,
"last_name": "Becker",
"primary": false,
"remote_id": "88",
"updated_at": "2021-11-23T14:37:45Z",
"updated_in_db_at": "2021-11-23T14:37:45Z"
}
}
],
"meta": {
"pagination": {
"page": 1,
"per_page": 25,
"total_count": 1,
"total_pages": 1
},
"sort": null,
"filter": {
}
}
}Fields
data
Type
[Key Account]
Description An array of Key Accounts
Key Account [POST]
Key Account [POST]
Request
Endpoint
POST /api/v2/user/key_accounts
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "key_accounts",
"attributes": {
"email": "[email protected]",
"first_name": "Rema",
"last_name": "Frami",
"remote_id": 87,
"updated_in_db_at": "2021-11-23 14:37:45 UTC"
}
}
}Parameters
Attributes
created_at
Type
date
Description The timestamp of when this resource was created
Required No
Type
string
Description Email
Required No
first_name
Type
string
Description First Name
Required No
last_download
Type
string
Description Last Download
Required No
last_name
Type
string
Description Last Name
Required No
primary
Type
boolean
Description Primary
Required No
remote_id
Type
number
Description Key Account SSO GUID
Required No
updated_at
Type
date
Description The timestamp of when this resource was last updated
Required No
updated_in_db_at
Type
date
Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.
Required No
Response
Headers
Content-Type: application/vnd.api+json; charset=utf-8
201 CreatedBody
{
"data": {
"id": "636a7d03-257d-415f-b234-7deb40412ef2",
"type": "key_accounts",
"attributes": {
"created_at": "2021-11-23T14:37:45Z",
"email": "[email protected]",
"first_name": "Rema",
"last_download": null,
"last_name": "Frami",
"primary": false,
"remote_id": "87",
"updated_at": "2021-11-23T14:37:45Z",
"updated_in_db_at": "2021-11-23T14:37:45Z"
}
}
}Fields
Attributes
created_at
Type
date
Description The timestamp of when this resource was created
Type
string
Description Email
first_name
Type
string
Description First Name
last_download
Type
string
Description Last Download
last_name
Type
string
Description Last Name
primary
Type
boolean
Description Primary
remote_id
Type
number
Description Key Account SSO GUID
updated_at
Type
date
Description The timestamp of when this resource was last updated
updated_in_db_at
Type
date
Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.
Key Account [GET]
Key Account [GET]
Request
Endpoint
GET /api/v2/user/key_accounts/2c92f507-a050-41e8-b41f-86611496db68
Content-Type: application/vnd.api+jsonBody
Response
Headers
Content-Type: application/vnd.api+json; charset=utf-8
200 OKBody
{
"data": {
"id": "2c92f507-a050-41e8-b41f-86611496db68",
"type": "key_accounts",
"attributes": {
"created_at": "2021-11-23T14:37:45Z",
"email": "[email protected]",
"first_name": "Joshua",
"last_download": null,
"last_name": "Wyman",
"primary": false,
"remote_id": "89",
"updated_at": "2021-11-23T14:37:45Z",
"updated_in_db_at": "2021-11-23T14:37:45Z"
}
}
}Fields
Attributes
created_at
Type
date
Description The timestamp of when this resource was created
Type
string
Description Email
first_name
Type
string
Description First Name
last_download
Type
string
Description Last Download
last_name
Type
string
Description Last Name
primary
Type
boolean
Description Primary
remote_id
Type
number
Description Key Account SSO GUID
updated_at
Type
date
Description The timestamp of when this resource was last updated
updated_in_db_at
Type
date
Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.
Key Account [PUT]
Key Account [PUT]
Request
Endpoint
PUT /api/v2/user/key_accounts/6efbcab3-fb1f-48a5-bec2-27faeeac7db9
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "key_accounts",
"attributes": {
"email": "[email protected]",
"first_name": "Veola",
"last_name": "Homenick",
"remote_id": 85,
"updated_in_db_at": "2021-11-23 14:37:44 UTC"
}
}
}Parameters
Attributes
created_at
Type
date
Description The timestamp of when this resource was created
Required No
Type
string
Description Email
Required No
first_name
Type
string
Description First Name
Required No
last_download
Type
string
Description Last Download
Required No
last_name
Type
string
Description Last Name
Required No
overwrite
Type
boolean
Description
Only used for updating a record where you want to ignore the server's ' 'updated_in_db_at value and force overwrite the values for the record. ' 'Must be true to work.
Required No
primary
Type
boolean
Description Primary
Required No
remote_id
Type
number
Description Key Account SSO GUID
Required No
updated_at
Type
date
Description The timestamp of when this resource was last updated
Required No
updated_in_db_at
Type
date
Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.
Required No
Response
Headers
Content-Type: application/vnd.api+json; charset=utf-8
200 OKBody
{
"data": {
"id": "6efbcab3-fb1f-48a5-bec2-27faeeac7db9",
"type": "key_accounts",
"attributes": {
"created_at": "2021-11-23T14:37:44Z",
"email": "[email protected]",
"first_name": "Veola",
"last_download": null,
"last_name": "Homenick",
"primary": false,
"remote_id": "85",
"updated_at": "2021-11-23T14:37:44Z",
"updated_in_db_at": "2021-11-23T14:37:44Z"
}
}
}Fields
Attributes
created_at
Type
date
Description The timestamp of when this resource was created
Type
string
Description Email
first_name
Type
string
Description First Name
last_download
Type
string
Description Last Download
last_name
Type
string
Description Last Name
primary
Type
boolean
Description Primary
remote_id
Type
number
Description Key Account SSO GUID
updated_at
Type
date
Description The timestamp of when this resource was last updated
updated_in_db_at
Type
date
Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.
Last updated