Key Accounts

Key Accounts Documentation

Key Account [LIST]

Key Account [LIST]

Request

Endpoint

GET /api/v2/user/key_accounts
Content-Type: application/vnd.api+json

Body

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": [
    {
      "id": "54ecd774-ac41-4026-a103-03893eedeb53",
      "type": "key_accounts",
      "attributes": {
        "created_at": "2021-11-23T14:37:45Z",
        "email": "dan@walker.info",
        "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+json

Body

{
  "data": {
    "type": "key_accounts",
    "attributes": {
      "email": "yong.satterfield@mayert.co",
      "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

email

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 Created

Body

{
  "data": {
    "id": "636a7d03-257d-415f-b234-7deb40412ef2",
    "type": "key_accounts",
    "attributes": {
      "created_at": "2021-11-23T14:37:45Z",
      "email": "yong.satterfield@mayert.co",
      "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

email

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+json

Body

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": {
    "id": "2c92f507-a050-41e8-b41f-86611496db68",
    "type": "key_accounts",
    "attributes": {
      "created_at": "2021-11-23T14:37:45Z",
      "email": "parker.tromp@pfannerstill.io",
      "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

email

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+json

Body

{
  "data": {
    "type": "key_accounts",
    "attributes": {
      "email": "jesica@dibbert.org",
      "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

email

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 OK

Body

{
  "data": {
    "id": "6efbcab3-fb1f-48a5-bec2-27faeeac7db9",
    "type": "key_accounts",
    "attributes": {
      "created_at": "2021-11-23T14:37:44Z",
      "email": "jesica@dibbert.org",
      "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

email

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