Mistake on this page? Email us

Account Management API

API for managing accounts, users, creating API keys, uploading trusted certificates
Version: v3
Host: https://api.us-east-1.mbedcloud.com

Endpoints

AccountAdmin

post /v3/api-keys/{apikey_id}/groups
Add API key to a list of groups. Show more Show less

An endpoint for adding API key to groups.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/api-keys/{apikey_id}/groups -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
apikey_id (required)
Path Parameter — The ID of the API key to be added to the group.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body string (required)
Body Parameter — A list of IDs of the groups to be updated.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A group or an API key with that ID does not exist. ErrorResponse
409 The API key is a member of the group already. ErrorResponse
post /v3/trusted-certificates
Upload a new trusted certificate. Show more Show less

An endpoint for uploading new trusted certificates.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/trusted-certificates -d {"name": "myCert1", "description": "very important cert", "certificate": "certificate_data", "service": "lwm2m"} -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body TrustedCertificateReq (required)
Body Parameter — A trusted certificate object with attributes.
Return type
Example data
Content-Type: application/json
{
  "enrollment_mode" : false,
  "owner_id" : "01619571dad80242ac12000600000000",
  "subject" : "CN=subject",
  "certificate" : "-----BEGIN CERTIFICATE----- ... -----END CERTIFICATE-----",
  "created_at" : "2018-02-13T09:35:20Z",
  "description" : "Certificate created by me.",
  "device_execution_mode" : 1,
  "issuer" : "CN=issuer",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "service" : "lwm2m",
  "name" : "My certificate",
  "etag" : "1",
  "id" : "01619571d01d0242ac12000600000000",
  "validity" : "2038-02-14T15:24:14Z",
  "object" : "trusted-cert",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
201 New entity created. TrustedCertificateResp
400 Invalid certificate data or missing/invalid parameters. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden, only available for admins of commercial accounts. ErrorResponse
409 Certificate with the given name or subject already exists. ErrorResponse
post /v3/policy-groups/{group_id}
Add members to a group. Show more Show less

An endpoint for adding users and API keys to a group.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/policy-groups/{group_id} -d '{"users": ["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
group_id (required)
Path Parameter — The ID of the group to be updated.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body SubjectList (required)
Body Parameter — A list of users and API keys to be added to the group.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data, for example the user or API key does not exist. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A group with that ID does not exist. ErrorResponse
409 The user of this API key is a member of the group already. ErrorResponse
post /v3/users/{user_id}/groups
Add user to a list of groups. Show more Show less

An endpoint for adding user to groups.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/users/{user_id}/groups -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
user_id (required)
Path Parameter — The ID of the user to be added to the group.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body string (required)
Body Parameter — A list of IDs of the groups to be updated.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A user or a group with that ID does not exist. ErrorResponse
409 The user is a member of the group already. ErrorResponse
post /v3/policy-groups
Create a new group. Show more Show less

An endpoint for creating a new group.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/policy-groups -d '{"name": "MyGroup1"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body GroupCreationInfo (required)
Body Parameter — Details of the group to be created.
Return type
Example data
Content-Type: application/json
{
  "apikey_count" : 0,
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "user_count" : 1,
  "name" : "Administrators",
  "created_at" : "2018-02-13T09:35:20Z",
  "etag" : "1",
  "id" : "01619571dec00242ac12000600000000",
  "object" : "group"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
201 New entity created. GroupSummary
400 Error in input data, for example invalid group name. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
409 A group with that name already exists. ErrorResponse
post /v3/users
Create a new user. Show more Show less

An endpoint for creating or inviting a new user to the account. In case of invitation email address is used only, other attributes are set in the 2nd step.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/users?action=invite -d {"email": "myemail@company.com"} -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body UserInfoReq (required)
Body Parameter — A user object with attributes.
Query parameters
action (optional)
Query Parameter — Action, either 'create' or 'invite'. default: create
Return type
Example data
Content-Type: application/json
{
  "creation_time" : 1518630727683,
  "address" : "110 Fulbourn Rd, Cambridge, United Kingdom",
  "email_verified" : true,
  "last_login_time" : 1518630727688,
  "password_changed_time" : 1518630727688,
  "is_marketing_accepted" : true,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "is_gtc_accepted" : true,
  "is_totp_enabled" : true,
  "password" : "PZf9eEUH43DAPE9ULINFeuj",
  "full_name" : "User Doe",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "login_history" : [ {
    "date" : "2018-02-14T17:52:07Z",
    "success" : true,
    "ip_address" : "127.0.0.1",
    "user_agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2227.1 Safari/537.36"
  } ],
  "etag" : "1",
  "phone_number" : "+44 (1223) 400 400",
  "id" : "01619571e2e89242ac12000600000000",
  "email" : "user@arm.com",
  "login_profiles" : [ {
    "name" : "aeiou",
    "id" : "aeiou",
    "type" : "NATIVE"
  } ],
  "object" : "user",
  "status" : "ACTIVE",
  "username" : "admin"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
201 New entity created. UserInfoResp
400 Error in input data, for example an invalid email address. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
409 A user with the given username or email already exists. ErrorResponse
delete /v3/policy-groups/{group_id}
Delete a group. Show more Show less

An endpoint for deleting a group.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/policy-groups/{group_id} -H 'Authorization: Bearer API_KEY'

Path parameters
group_id (required)
Path Parameter — The ID of the group to be deleted.
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
204 Deleted successfully.
401 Authentication failure. ErrorResponse
403 Forbidden or Administrators group cannot be removed. ErrorResponse
404 A group with that ID does not exist. ErrorResponse
delete /v3/users/{user_id}

An endpoint for deleting a user.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/users/{user_id} -H 'Authorization: Bearer API_KEY'

Path parameters
user_id (required)
Path Parameter — The ID of the user to be deleted.
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
204 Deleted successfully.
400 Bad request, for example trying to delete active user. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A user with the specified ID does not exist. ErrorResponse
get /v3/users
Get the details of all users. Show more Show less

An endpoint for retrieving the details of all users.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/users -H 'Authorization: Bearer API_KEY'

Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
email__eq (optional)
Query Parameter — Filter for email address
status__eq (optional)
Query Parameter — Filter for status, for example active or reset
status__in (optional)
Query Parameter — An optional filter for getting users with a specified set of statuses.
status__nin (optional)
Query Parameter — An optional filter for excluding users with a specified set of statuses.
login_profile__eq (optional)
Query Parameter — An optional filter for getting users with a specified login profile.
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "creation_time" : 1518630727683,
    "address" : "110 Fulbourn Rd, Cambridge, United Kingdom",
    "email_verified" : true,
    "last_login_time" : 1518630727688,
    "password_changed_time" : 1518630727688,
    "is_marketing_accepted" : true,
    "created_at" : "2018-02-13T09:35:20Z",
    "groups" : [ "aeiou" ],
    "is_gtc_accepted" : true,
    "is_totp_enabled" : true,
    "password" : "PZf9eEUH43DAPE9ULINFeuj",
    "full_name" : "User Doe",
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "login_history" : [ {
      "date" : "2018-02-14T17:52:07Z",
      "success" : true,
      "ip_address" : "127.0.0.1",
      "user_agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2227.1 Safari/537.36"
    } ],
    "etag" : "1",
    "phone_number" : "+44 (1223) 400 400",
    "id" : "01619571e2e89242ac12000600000000",
    "email" : "user@arm.com",
    "login_profiles" : [ {
      "name" : "aeiou",
      "id" : "aeiou",
      "type" : "NATIVE"
    } ],
    "object" : "user",
    "status" : "ACTIVE",
    "username" : "admin"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. UserInfoRespList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
get /v3/api-keys/{apikey_id}/groups
Get groups of the API key. Show more Show less

An endpoint for retrieving groups of the API key.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/api-keys/{apikey_id}/groups -H 'Authorization: Bearer API_KEY'

Path parameters
apikey_id (required)
Path Parameter — The ID of the API key whose details are retrieved.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "apikey_count" : 0,
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "user_count" : 1,
    "name" : "Administrators",
    "created_at" : "2018-02-13T09:35:20Z",
    "etag" : "1",
    "id" : "01619571dec00242ac12000600000000",
    "object" : "group"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. GroupSummaryList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An API key with the given ID does not exist. ErrorResponse
get /v3/users/{user_id}/groups
Get groups of the user. Show more Show less

An endpoint for retrieving groups of the user.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/users/{user_id}/groups -H 'Authorization: Bearer API_KEY'

Path parameters
user_id (required)
Path Parameter — The ID of the user whose details are retrieved.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "apikey_count" : 0,
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "user_count" : 1,
    "name" : "Administrators",
    "created_at" : "2018-02-13T09:35:20Z",
    "etag" : "1",
    "id" : "01619571dec00242ac12000600000000",
    "object" : "group"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. GroupSummaryList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A user with the given ID does not exist. ErrorResponse
get /v3/accounts/me/notifications
Get the notification events of an account. Show more Show less
Endpoint for retrieving notifications.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "account_id" : "01619571e2e90242ac12000600000000",
    "error_msg" : "Connection error.",
    "receiver" : "example@email-receiver.test",
    "subject" : "Account locked.",
    "success" : true,
    "created_at" : "2018-02-13T09:35:20Z",
    "etag" : "1",
    "id" : "01619571d01d0242ac12000600000000",
    "message" : "User limit has been reached.",
    "type" : "email",
    "object" : "notification-entry"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation NotificationEntryList
400 Error in input data, missing or invalid parameters. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden ErrorResponse
get /v3/users/{user_id}
Details of a user. Show more Show less

An endpoint for retrieving the details of a user.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/users/{user_id} -H 'Authorization: Bearer API_KEY'

Path parameters
user_id (required)
Path Parameter — The ID of the user whose details are retrieved.
Return type
Example data
Content-Type: application/json
{
  "creation_time" : 1518630727683,
  "address" : "110 Fulbourn Rd, Cambridge, United Kingdom",
  "email_verified" : true,
  "last_login_time" : 1518630727688,
  "password_changed_time" : 1518630727688,
  "is_marketing_accepted" : true,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "is_gtc_accepted" : true,
  "is_totp_enabled" : true,
  "password" : "PZf9eEUH43DAPE9ULINFeuj",
  "full_name" : "User Doe",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "login_history" : [ {
    "date" : "2018-02-14T17:52:07Z",
    "success" : true,
    "ip_address" : "127.0.0.1",
    "user_agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2227.1 Safari/537.36"
  } ],
  "etag" : "1",
  "phone_number" : "+44 (1223) 400 400",
  "id" : "01619571e2e89242ac12000600000000",
  "email" : "user@arm.com",
  "login_profiles" : [ {
    "name" : "aeiou",
    "id" : "aeiou",
    "type" : "NATIVE"
  } ],
  "object" : "user",
  "status" : "ACTIVE",
  "username" : "admin"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. UserInfoResp
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A user with the specified ID does not exist. ErrorResponse
get /v3/policy-groups/{group_id}/users
Get users of a group. Show more Show less

An endpoint for listing the users of a group with details.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/policy-groups/{group_id}/users -H 'Authorization: Bearer API_KEY'

Path parameters
group_id (required)
Path Parameter — The ID of the group whose users are retrieved.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
status__eq (optional)
Query Parameter — An optional filter for getting users by status.
status__in (optional)
Query Parameter — An optional filter for getting users with a specified set of statuses.
status__nin (optional)
Query Parameter — An optional filter for excluding users with a specified set of statuses.
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "creation_time" : 1518630727683,
    "address" : "110 Fulbourn Rd, Cambridge, United Kingdom",
    "email_verified" : true,
    "last_login_time" : 1518630727688,
    "password_changed_time" : 1518630727688,
    "is_marketing_accepted" : true,
    "created_at" : "2018-02-13T09:35:20Z",
    "groups" : [ "aeiou" ],
    "is_gtc_accepted" : true,
    "is_totp_enabled" : true,
    "password" : "PZf9eEUH43DAPE9ULINFeuj",
    "full_name" : "User Doe",
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "login_history" : [ {
      "date" : "2018-02-14T17:52:07Z",
      "success" : true,
      "ip_address" : "127.0.0.1",
      "user_agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2227.1 Safari/537.36"
    } ],
    "etag" : "1",
    "phone_number" : "+44 (1223) 400 400",
    "id" : "01619571e2e89242ac12000600000000",
    "email" : "user@arm.com",
    "login_profiles" : [ {
      "name" : "aeiou",
      "id" : "aeiou",
      "type" : "NATIVE"
    } ],
    "object" : "user",
    "status" : "ACTIVE",
    "username" : "admin"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. UserInfoRespList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A group with that ID does not exist. ErrorResponse
delete /v3/api-keys/{apikey_id}/groups
Remove API key from groups. Show more Show less

An endpoint for removing API key from groups.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/api-keys/{apikey_id}/groups -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
apikey_id (required)
Path Parameter — The ID of the API key to be removed from the group.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body string (required)
Body Parameter — A list of IDs of the groups to be updated.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data,. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An API key with that ID does not exist. ErrorResponse
delete /v3/users/{user_id}/groups
Remove user from groups. Show more Show less

An endpoint for removing user from groups.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/users/{user_id}/groups -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
user_id (required)
Path Parameter — The ID of the user to be removed from the group.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body string (required)
Body Parameter — A list of IDs of the groups to be updated.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A user with that ID does not exist. ErrorResponse
delete /v3/policy-groups/{group_id}/users
Remove users from a group. Show more Show less

An endpoint for removing users from groups.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/policy-groups/{group_id}/users -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
group_id (required)
Path Parameter — The ID of the group whose users are removed.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body SubjectList (required)
Body Parameter — A list of users to be removed from the group.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data, for example the user removes itself from the Administrators group. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A group with that ID does not exist. ErrorResponse
put /v3/policy-groups/{group_id}
Update the group name. Show more Show less

An endpoint for updating a group name.

Example usage: curl -X PUT https://api.us-east-1.mbedcloud.com/v3/policy-groups/{group_id} -d '{"name": "TestGroup2"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
group_id (required)
Path Parameter — The ID of the group to be updated.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body GroupUpdateInfo (required)
Body Parameter — Details of the group to be created.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data, for example the group name is too long. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A group with that ID does not exist. ErrorResponse
put /v3/accounts/me
Updates attributes of the account. Show more Show less

An endpoint for updating the account.

Example usage: curl -X PUT https://api.us-east-1.mbedcloud.com/v3/accounts/me -d '{"phone_number": "12345678"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body AccountUpdateReq (required)
Body Parameter — Details of the account to be updated.
Return type
Example data
Content-Type: application/json
{
  "country" : "United Kingdom",
  "reason" : "Subscription paid.",
  "aliases" : [ "aeiou" ],
  "city" : "Cambridge",
  "customer_number" : "1NC25_0001",
  "policies" : [ {
    "allow" : true,
    "feature" : "update-campaigns",
    "resource" : "/v3/update-campaign",
    "inherited" : false,
    "action" : "GET"
  } ],
  "sales_contact" : "sales@arm.com",
  "created_at" : "2018-02-13T09:35:20Z",
  "expiration_warning_threshold" : "180",
  "updated_at" : "2018-02-14T15:24:14Z",
  "address_line2" : " ",
  "tier" : "1",
  "address_line1" : "110 Fulbourn Rd",
  "contract_number" : "1NX25_0001",
  "contact" : "J. Doe",
  "reference_note" : "ARM-INT-0001",
  "company" : "ARM Holdings Plc",
  "id" : "01619571e2e90242ac12000600000000",
  "state" : " ",
  "idle_timeout" : "30",
  "email" : "info@arm.com",
  "limits" : {
    "key" : "aeiou"
  },
  "upgraded_at" : "2018-02-14T15:24:14Z",
  "custom_fields" : {
    "key" : "aeiou"
  },
  "display_name" : "ARM",
  "notification_emails" : [ "aeiou" ],
  "parent_account" : {
    "id" : "01619571dad80242ac12000600000000",
    "admin_name" : "J. Doe",
    "admin_email" : "info@arm.com"
  },
  "mfa_status" : "enforced",
  "password_policy" : {
    "minimum_length" : "8"
  },
  "end_market" : "IT",
  "parent_id" : "01619571dad80242ac12000600000000",
  "sub_accounts" : [ "" ],
  "etag" : "1",
  "phone_number" : "+44 (1223) 400 400",
  "template_id" : "01619571e7160242ac12000600000000",
  "postal_code" : "CB1 9NJ",
  "object" : "account",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation AccountInfo
400 Error in input data format. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
put /v3/users/{user_id}
Update user details. Show more Show less

An endpoint for updating user details.

Example usage: curl -X PUT https://api.us-east-1.mbedcloud.com/v3/users/{user_id} -d '{"username": "myusername"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
user_id (required)
Path Parameter — The ID of the user whose details are updated.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body UserUpdateReq (required)
Body Parameter — A user object with attributes.
Return type
Example data
Content-Type: application/json
{
  "creation_time" : 1518630727683,
  "address" : "110 Fulbourn Rd, Cambridge, United Kingdom",
  "email_verified" : true,
  "last_login_time" : 1518630727688,
  "password_changed_time" : 1518630727688,
  "is_marketing_accepted" : true,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "is_gtc_accepted" : true,
  "is_totp_enabled" : true,
  "password" : "PZf9eEUH43DAPE9ULINFeuj",
  "full_name" : "User Doe",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "login_history" : [ {
    "date" : "2018-02-14T17:52:07Z",
    "success" : true,
    "ip_address" : "127.0.0.1",
    "user_agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2227.1 Safari/537.36"
  } ],
  "etag" : "1",
  "phone_number" : "+44 (1223) 400 400",
  "id" : "01619571e2e89242ac12000600000000",
  "email" : "user@arm.com",
  "login_profiles" : [ {
    "name" : "aeiou",
    "id" : "aeiou",
    "type" : "NATIVE"
  } ],
  "object" : "user",
  "status" : "ACTIVE",
  "username" : "admin"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. UserInfoResp
400 Error in input data, for example an invalid email address. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A user with the given ID does not exist. ErrorResponse
409 A user with the given username or email already exists. ErrorResponse

AggregatorAccountAdmin

post /v3/accounts/{account_id}/api-keys/{apikey_id}/groups
Add API key to a list of groups. Show more Show less

An endpoint for adding API key to groups.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/api-keys/{apikey_id}/groups -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
apikey_id (required)
Path Parameter — The ID of the API key to be added to the group.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body string (required)
Body Parameter — A list of IDs of the groups to be updated.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or an API key with the specified ID does not exist ErrorResponse
409 The API key is a member of the group already. ErrorResponse
post /v3/accounts/{account_id}/trusted-certificates
Upload new trusted certificate. Show more Show less

An endpoint for uploading new trusted certificates.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/trusted-certificates -d {"name": "myCert1", "description": "very important cert", "certificate": "certificate_data", "service": "lwm2m"} -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
Body Parameter — A trusted certificate object with attributes, signature is optional.
Return type
Example data
Content-Type: application/json
{
  "enrollment_mode" : false,
  "owner_id" : "01619571dad80242ac12000600000000",
  "subject" : "CN=subject",
  "certificate" : "-----BEGIN CERTIFICATE----- ... -----END CERTIFICATE-----",
  "created_at" : "2018-02-13T09:35:20Z",
  "description" : "Certificate created by me.",
  "device_execution_mode" : 1,
  "issuer" : "CN=issuer",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "service" : "lwm2m",
  "name" : "My certificate",
  "etag" : "1",
  "id" : "01619571d01d0242ac12000600000000",
  "validity" : "2038-02-14T15:24:14Z",
  "object" : "trusted-cert",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
201 New entity created. TrustedCertificateResp
400 Invalid certificate data, certificate validation failed, certificate already expired or certificate uses unsupported, weak cipher. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden, only available for admins of commercial accounts. ErrorResponse
404 An account with the given ID does not exist. ErrorResponse
post /v3/accounts/{account_id}/users/{user_id}/groups
Add user to a list of groups. Show more Show less

An endpoint for adding user to groups.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/users/{user_id}/groups -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
user_id (required)
Path Parameter — The ID of the user to be added to the group.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body string (required)
Body Parameter — A list of IDs of the groups to be updated.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account, a user or a group with that ID does not exist. ErrorResponse
409 The user is a member of the group already. ErrorResponse
post /v3/accounts/{account_id}/policy-groups/{group_id}
Add members to a group. Show more Show less

An endpoint for adding users and API keys to groups.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/policy-groups/{group_id} -d '{"users": ["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
group_id (required)
Path Parameter — The ID of the group to be updated.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body SubjectList (required)
Body Parameter — A list of users and API keys to be added to the group.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data, for example the user or API key does not exist. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or a group with that ID does not exist. ErrorResponse
409 The user of this API key is a member of the group already. ErrorResponse
post /v3/accounts
Create a new account. Show more Show less

An endpoint for creating a new account.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/accounts -d '{"display_name": "MyAccount1", "admin_name": "accountAdmin1", "email": "example_admin@myaccount.info", "country": "United Kingdom", "end_market": "Smart City", "address_line1": "110 Fulbourn Rd", "city": "Cambridge", "contact": "J. Doe", "company": "Arm"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body AccountCreationReq (required)
Body Parameter — Details of the account to be created.
Query parameters
action (optional)
Query Parameter — Action, either 'create' or 'enroll'.
  • 'create' creates the account where its admin user has ACTIVE status if admin_password was defined in the request, or RESET status if no admin_password was defined. If the user already exists, its status is not modified.
  • 'enroll' creates the account where its admin user has ENROLLING status. If the user already exists, its status is not modified. Email to finish the enrollment or to notify the existing user about the new account is sent to the admin_email defined in the request.
default: create
Return type
Example data
Content-Type: application/json
{
  "country" : "United Kingdom",
  "aliases" : [ "aeiou" ],
  "city" : "Cambridge",
  "customer_number" : "1NC25_0001",
  "display_name" : "ARM",
  "admin_password" : "PZf9eEUH43DAPE9ULINFeuj",
  "admin_email" : "admin@arm.com",
  "admin_full_name" : "Admin Doe",
  "end_market" : "IT",
  "address_line2" : " ",
  "address_line1" : "110 Fulbourn Rd",
  "contract_number" : "1NX25_0001",
  "admin_id" : "01619571e2e89242ac12000600000000",
  "contact" : "J. Doe",
  "company" : "ARM Holdings Plc",
  "phone_number" : "+44 (1223) 400 400",
  "id" : "01619571e2e90242ac12000600000000",
  "state" : " ",
  "admin_name" : "admin",
  "postal_code" : "CB1 9NJ",
  "admin_key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000B40IkJADMANmAscAj0Ot0n2yeQnyt9tT",
  "email" : "info@arm.com"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
201 Successful operation. AccountCreationResp
400 Error in input data, for example invalid username. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
post /v3/accounts/{account_id}/api-keys
Create a new API key. Show more Show less

An endpoint for creating a new API key. There is no default value for the owner ID and it must be from the same account where the new API key is created.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/api-keys -d '{"name": "MyKey1"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body ApiKeyInfoReq (required)
Body Parameter — Details of the API key to be created.
Return type
Example data
Content-Type: application/json
{
  "owner" : "01619571e2e89242ac12000600000000",
  "creation_time" : 1518630727683,
  "last_login_time" : 1518630727688,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "name" : "API key gorgon",
  "etag" : "1",
  "id" : "01619571f7020242ac12000600000000",
  "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
  "object" : "api-key",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
201 New entity created. ApiKeyInfoResp
400 Error in input data, for example missing display name. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account with the given ID does not exist. ErrorResponse
post /v3/accounts/{account_id}/policy-groups
Create a new group. Show more Show less

An endpoint for creating a new group.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/policy-groups -d '{"name": "MyGroup1"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body GroupCreationInfo (required)
Body Parameter — Details of the group to be created.
Return type
Example data
Content-Type: application/json
{
  "apikey_count" : 0,
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "user_count" : 1,
  "name" : "Administrators",
  "created_at" : "2018-02-13T09:35:20Z",
  "etag" : "1",
  "id" : "01619571dec00242ac12000600000000",
  "object" : "group"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
201 New entity created. GroupSummary
400 Error in input data, for example invalid group name. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account with the specified ID does not exist. ErrorResponse
409 A group with that name already exists. ErrorResponse
post /v3/accounts/{account_id}/users
Create a new user. Show more Show less

An endpoint for creating or inviting a new user to the account. In case of invitation email address is used only, other attributes are set in the 2nd step.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/users -d {"email": "myemail@company.com"} -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body UserInfoReq (required)
Body Parameter — A user object with attributes.
Query parameters
action (optional)
Query Parameter — Create or invite user. default: create
Return type
Example data
Content-Type: application/json
{
  "creation_time" : 1518630727683,
  "address" : "110 Fulbourn Rd, Cambridge, United Kingdom",
  "email_verified" : true,
  "last_login_time" : 1518630727688,
  "password_changed_time" : 1518630727688,
  "is_marketing_accepted" : true,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "is_gtc_accepted" : true,
  "is_totp_enabled" : true,
  "password" : "PZf9eEUH43DAPE9ULINFeuj",
  "full_name" : "User Doe",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "login_history" : [ {
    "date" : "2018-02-14T17:52:07Z",
    "success" : true,
    "ip_address" : "127.0.0.1",
    "user_agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2227.1 Safari/537.36"
  } ],
  "etag" : "1",
  "phone_number" : "+44 (1223) 400 400",
  "id" : "01619571e2e89242ac12000600000000",
  "email" : "user@arm.com",
  "login_profiles" : [ {
    "name" : "aeiou",
    "id" : "aeiou",
    "type" : "NATIVE"
  } ],
  "object" : "user",
  "status" : "ACTIVE",
  "username" : "admin"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
201 New entity created. UserInfoResp
400 Error in input data, for example an invalid email address. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account with the specified ID does not exist. ErrorResponse
409 A user with the given username or email already exists. ErrorResponse
delete /v3/accounts/{account_id}/api-keys/{apikey_id}
Delete the API key. Show more Show less

An endpoint for deleting an API key.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/api-keys/{apikey_id} -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
apikey_id (required)
Path Parameter — The ID of the API key to be deleted.
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
204 Deleted successfully.
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or API key with the specified ID does not exist. ErrorResponse
delete /v3/accounts/{account_id}/trusted-certificates/{cert_id}
Delete trusted certificate by ID. Show more Show less

An endpoint for deleting the trusted certificate.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/trusted-certificates/{cert_id} -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
cert_id (required)
Path Parameter — The ID of the trusted certificate to be deleted.
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
204 Deleted successfully.
401 Authentication failure. ErrorResponse
403 Forbidden, only available for admins of commercial accounts. ErrorResponse
404 Account or certificate with the given ID not found. ErrorResponse
delete /v3/accounts/{account_id}/policy-groups/{group_id}
Delete a group. Show more Show less

An endpoint for deleting a group.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/policy-groups/{group_id} -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
group_id (required)
Path Parameter — The ID of the group to be deleted.
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
204 Deleted successfully.
401 Authentication failure. ErrorResponse
403 Forbidden or Administrators group cannot be removed. ErrorResponse
404 An account or group with that ID does not exist. ErrorResponse
delete /v3/accounts/{account_id}/users/{user_id}

An endpoint for deleting a user.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/users/{user_id} -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
user_id (required)
Path Parameter — The ID of the user to be deleted.
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
204 Deleted successfully.
400 Bad request, for example trying to delete an active user. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or a user with the specified ID does not exist. ErrorResponse
get /v3/accounts/{account_id}/api-keys/{apikey_id}
Get API key details. Show more Show less

An endpoint for retrieving API key details.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/api-keys/{apikey_id} -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
apikey_id (required)
Path Parameter — The ID of the API key to be retrieved.
Return type
Example data
Content-Type: application/json
{
  "owner" : "01619571e2e89242ac12000600000000",
  "creation_time" : 1518630727683,
  "last_login_time" : 1518630727688,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "name" : "API key gorgon",
  "etag" : "1",
  "id" : "01619571f7020242ac12000600000000",
  "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
  "object" : "api-key",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation ApiKeyInfoResp
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or API key with the specified ID does not exist. ErrorResponse
get /v3/accounts/{account_id}/trusted-certificates/{cert_id}
Get trusted certificate by ID. Show more Show less

An endpoint for retrieving a trusted certificate by ID.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/trusted-certificates/{cert_id} -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
cert_id (required)
Path Parameter — The ID of the trusted certificate to be retrieved.
Return type
Example data
Content-Type: application/json
{
  "enrollment_mode" : false,
  "owner_id" : "01619571dad80242ac12000600000000",
  "subject" : "CN=subject",
  "certificate" : "-----BEGIN CERTIFICATE----- ... -----END CERTIFICATE-----",
  "created_at" : "2018-02-13T09:35:20Z",
  "description" : "Certificate created by me.",
  "device_execution_mode" : 1,
  "private_key" : "MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmE...",
  "issuer" : "CN=issuer",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "service" : "lwm2m",
  "name" : "My certificate",
  "etag" : "1",
  "id" : "01619571d01d0242ac12000600000000",
  "validity" : "2038-02-14T15:24:14Z",
  "object" : "trusted-cert",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation TrustedCertificateInternalResp
401 Authentication failure. ErrorResponse
403 Forbidden, only available for admins of commercial accounts. ErrorResponse
404 Account or certificate with the given ID not found. ErrorResponse
get /v3/accounts/{account_id}/policy-groups/{group_id}
Get group information. Show more Show less

An endpoint for getting general information about the group.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/policy-groups/{group_id} -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
group_id (required)
Path Parameter — The ID of the group to be retrieved.
Return type
Example data
Content-Type: application/json
{
  "apikey_count" : 0,
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "user_count" : 1,
  "name" : "Administrators",
  "created_at" : "2018-02-13T09:35:20Z",
  "etag" : "1",
  "id" : "01619571dec00242ac12000600000000",
  "object" : "group"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation GroupSummary
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or a group with that ID does not exist. ErrorResponse
get /v3/accounts/{account_id}
Get account info. Show more Show less

Returns detailed information about the account.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id} -H 'Authorization: Bearer API_KEY'.

Path parameters
account_id (required)
Path Parameter — The ID of the account to be fetched.
Query parameters
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: limits, policies, sub_accounts
properties (optional)
Query Parameter — Property name to be returned from account specific properties.
Return type
Example data
Content-Type: application/json
{
  "country" : "United Kingdom",
  "reason" : "Subscription paid.",
  "aliases" : [ "aeiou" ],
  "city" : "Cambridge",
  "customer_number" : "1NC25_0001",
  "policies" : [ {
    "allow" : true,
    "feature" : "update-campaigns",
    "resource" : "/v3/update-campaign",
    "inherited" : false,
    "action" : "GET"
  } ],
  "sales_contact" : "sales@arm.com",
  "created_at" : "2018-02-13T09:35:20Z",
  "expiration_warning_threshold" : "180",
  "updated_at" : "2018-02-14T15:24:14Z",
  "address_line2" : " ",
  "tier" : "1",
  "address_line1" : "110 Fulbourn Rd",
  "contract_number" : "1NX25_0001",
  "contact" : "J. Doe",
  "reference_note" : "ARM-INT-0001",
  "company" : "ARM Holdings Plc",
  "id" : "01619571e2e90242ac12000600000000",
  "state" : " ",
  "idle_timeout" : "30",
  "email" : "info@arm.com",
  "limits" : {
    "key" : "aeiou"
  },
  "upgraded_at" : "2018-02-14T15:24:14Z",
  "custom_fields" : {
    "key" : "aeiou"
  },
  "display_name" : "ARM",
  "notification_emails" : [ "aeiou" ],
  "parent_account" : {
    "id" : "01619571dad80242ac12000600000000",
    "admin_name" : "J. Doe",
    "admin_email" : "info@arm.com"
  },
  "mfa_status" : "enforced",
  "password_policy" : {
    "minimum_length" : "8"
  },
  "end_market" : "IT",
  "parent_id" : "01619571dad80242ac12000600000000",
  "sub_accounts" : [ "" ],
  "etag" : "1",
  "phone_number" : "+44 (1223) 400 400",
  "template_id" : "01619571e7160242ac12000600000000",
  "postal_code" : "CB1 9NJ",
  "object" : "account",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation AccountInfo
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 Account with the given ID not found. ErrorResponse
get /v3/accounts/{account_id}/notifications
Get the notification events of an account. Show more Show less
Endpoint for retrieving notifications.
Path parameters
account_id (required)
Path Parameter — Account ID.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "account_id" : "01619571e2e90242ac12000600000000",
    "error_msg" : "Connection error.",
    "receiver" : "example@email-receiver.test",
    "subject" : "Account locked.",
    "success" : true,
    "created_at" : "2018-02-13T09:35:20Z",
    "etag" : "1",
    "id" : "01619571d01d0242ac12000600000000",
    "message" : "User limit has been reached.",
    "type" : "email",
    "object" : "notification-entry"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation NotificationEntryList
400 Error in input data, missing or invalid parameters. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden ErrorResponse
404 Account with the given ID not found. ErrorResponse
get /v3/accounts/{account_id}/users/{user_id}
Details of the user. Show more Show less

An endpoint for retrieving details of the user.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/users/{user_id} -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
user_id (required)
Path Parameter — The ID of the user to be retrieved.
Return type
Example data
Content-Type: application/json
{
  "creation_time" : 1518630727683,
  "address" : "110 Fulbourn Rd, Cambridge, United Kingdom",
  "email_verified" : true,
  "last_login_time" : 1518630727688,
  "password_changed_time" : 1518630727688,
  "is_marketing_accepted" : true,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "is_gtc_accepted" : true,
  "is_totp_enabled" : true,
  "password" : "PZf9eEUH43DAPE9ULINFeuj",
  "full_name" : "User Doe",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "login_history" : [ {
    "date" : "2018-02-14T17:52:07Z",
    "success" : true,
    "ip_address" : "127.0.0.1",
    "user_agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2227.1 Safari/537.36"
  } ],
  "etag" : "1",
  "phone_number" : "+44 (1223) 400 400",
  "id" : "01619571e2e89242ac12000600000000",
  "email" : "user@arm.com",
  "login_profiles" : [ {
    "name" : "aeiou",
    "id" : "aeiou",
    "type" : "NATIVE"
  } ],
  "object" : "user",
  "status" : "ACTIVE",
  "username" : "admin"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UserInfoResp
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or user with the specified ID does not exist. ErrorResponse
get /v3/accounts/{account_id}/api-keys
Get all API keys. Show more Show less

An endpoint for retrieving the API keys in an array, optionally filtered by the owner.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/api-keys -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
key__eq (optional)
Query Parameter — API key filter. Do not include the private part of the API key (the last 32 characters).
owner__eq (optional)
Query Parameter — Owner name filter.
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "owner" : "01619571e2e89242ac12000600000000",
    "creation_time" : 1518630727683,
    "last_login_time" : 1518630727688,
    "created_at" : "2018-02-13T09:35:20Z",
    "groups" : [ "aeiou" ],
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "name" : "API key gorgon",
    "etag" : "1",
    "id" : "01619571f7020242ac12000600000000",
    "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
    "object" : "api-key",
    "status" : "ACTIVE"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation ApiKeyInfoRespList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account with the given ID does not exist. ErrorResponse
get /v3/accounts/{account_id}/trusted-certificates
Get all trusted certificates. Show more Show less

An endpoint for retrieving trusted certificates in an array.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/trusted-certificates -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
name__eq (optional)
Query Parameter — Filter for certificate name
service__eq (optional)
Query Parameter — Filter for service
expire__eq (optional)
Query Parameter — Filter for expire format: int32
device_execution_mode__eq (optional)
Query Parameter — Filter for developer certificates format: int32
device_execution_mode__neq (optional)
Query Parameter — Filter for not developer certificates format: int32
owner__eq (optional)
Query Parameter — Owner name filter
enrollment_mode__eq (optional)
Query Parameter — Enrollment mode filter
status__eq (optional)
Query Parameter — Filter for certificate status
issuer__like (optional)
Query Parameter — Filter for issuer. Finds all matches where the filter value is a case insensitive substring of the result. Example: issuer__like=cn=iss matches CN=issuer.
subject__like (optional)
Query Parameter — Filter for subject. Finds all matches where the filter value is a case insensitive substring of the result. Example: subject__like=cn=su matches CN=subject.
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "enrollment_mode" : false,
    "owner_id" : "01619571dad80242ac12000600000000",
    "subject" : "CN=subject",
    "certificate" : "-----BEGIN CERTIFICATE----- ... -----END CERTIFICATE-----",
    "created_at" : "2018-02-13T09:35:20Z",
    "description" : "Certificate created by me.",
    "device_execution_mode" : 1,
    "private_key" : "MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmE...",
    "issuer" : "CN=issuer",
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "service" : "lwm2m",
    "name" : "My certificate",
    "etag" : "1",
    "id" : "01619571d01d0242ac12000600000000",
    "validity" : "2038-02-14T15:24:14Z",
    "object" : "trusted-cert",
    "status" : "ACTIVE"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation TrustedCertificateInternalRespList
401 Authentication failure. ErrorResponse
403 Forbidden, only available for admins of commercial accounts. ErrorResponse
404 An account with the given ID does not exist. ErrorResponse
get /v3/accounts/{account_id}/policy-groups
Get all group information. Show more Show less

An endpoint for retrieving all group information.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/policy-groups -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
name__eq (optional)
Query Parameter — Filter for group name
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "apikey_count" : 0,
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "user_count" : 1,
    "name" : "Administrators",
    "created_at" : "2018-02-13T09:35:20Z",
    "etag" : "1",
    "id" : "01619571dec00242ac12000600000000",
    "object" : "group"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation GroupSummaryList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account with the specified ID does not exist. ErrorResponse
get /v3/accounts/{account_id}/users
Get all user details. Show more Show less

An endpoint for retrieving details of all users.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/users -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
email__eq (optional)
Query Parameter — Filter for email address
status__eq (optional)
Query Parameter — Filter for status
status__in (optional)
Query Parameter — An optional filter for getting users with a specified set of statuses.
status__nin (optional)
Query Parameter — An optional filter for excluding users with a specified set of statuses.
login_profile__eq (optional)
Query Parameter — An optional filter for getting users with a specified login profile.
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "creation_time" : 1518630727683,
    "address" : "110 Fulbourn Rd, Cambridge, United Kingdom",
    "email_verified" : true,
    "last_login_time" : 1518630727688,
    "password_changed_time" : 1518630727688,
    "is_marketing_accepted" : true,
    "created_at" : "2018-02-13T09:35:20Z",
    "groups" : [ "aeiou" ],
    "is_gtc_accepted" : true,
    "is_totp_enabled" : true,
    "password" : "PZf9eEUH43DAPE9ULINFeuj",
    "full_name" : "User Doe",
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "login_history" : [ {
      "date" : "2018-02-14T17:52:07Z",
      "success" : true,
      "ip_address" : "127.0.0.1",
      "user_agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2227.1 Safari/537.36"
    } ],
    "etag" : "1",
    "phone_number" : "+44 (1223) 400 400",
    "id" : "01619571e2e89242ac12000600000000",
    "email" : "user@arm.com",
    "login_profiles" : [ {
      "name" : "aeiou",
      "id" : "aeiou",
      "type" : "NATIVE"
    } ],
    "object" : "user",
    "status" : "ACTIVE",
    "username" : "admin"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UserInfoRespList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account with the given ID does not exist. ErrorResponse
get /v3/accounts
Get all accounts. Show more Show less

Returns an array of account objects, optionally filtered by status and tier level.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts -H 'Authorization: Bearer API_KEY'.

Query parameters
status__eq (optional)
Query Parameter — An optional filter for account status, ENROLLING, ACTIVE, RESTRICTED or SUSPENDED.
status__in (optional)
Query Parameter — An optional filter for getting accounts with a specified set of statuses.
status__nin (optional)
Query Parameter — An optional filter for excluding accounts with a specified set of statuses.
tier__eq (optional)
Query Parameter — An optional filter for tier level, must be 0, 1, 2, 98, 99 or omitted.
parent__eq (optional)
Query Parameter — An optional filter for parent account ID.
end_market__eq (optional)
Query Parameter — An optional filter for account end market.
country__like (optional)
Query Parameter — An optional filter for account country. Finds all matches where the filter value is a case insensitive substring of the result. Example: country__like=LAND matches Ireland.
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 1000. default: 1000 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC. Default value is ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: limits, policies, sub_accounts
format (optional)
Query Parameter — Format information for the response to the query, supported: format=breakdown.
properties (optional)
Query Parameter — Property name to be returned from account specific properties.
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "country" : "United Kingdom",
    "reason" : "Subscription paid.",
    "aliases" : [ "aeiou" ],
    "city" : "Cambridge",
    "customer_number" : "1NC25_0001",
    "policies" : [ {
      "allow" : true,
      "feature" : "update-campaigns",
      "resource" : "/v3/update-campaign",
      "inherited" : false,
      "action" : "GET"
    } ],
    "sales_contact" : "sales@arm.com",
    "created_at" : "2018-02-13T09:35:20Z",
    "expiration_warning_threshold" : "180",
    "updated_at" : "2018-02-14T15:24:14Z",
    "address_line2" : " ",
    "tier" : "1",
    "address_line1" : "110 Fulbourn Rd",
    "contract_number" : "1NX25_0001",
    "contact" : "J. Doe",
    "reference_note" : "ARM-INT-0001",
    "company" : "ARM Holdings Plc",
    "id" : "01619571e2e90242ac12000600000000",
    "state" : " ",
    "idle_timeout" : "30",
    "email" : "info@arm.com",
    "limits" : {
      "key" : "aeiou"
    },
    "upgraded_at" : "2018-02-14T15:24:14Z",
    "custom_fields" : {
      "key" : "aeiou"
    },
    "display_name" : "ARM",
    "notification_emails" : [ "aeiou" ],
    "parent_account" : {
      "id" : "01619571dad80242ac12000600000000",
      "admin_name" : "J. Doe",
      "admin_email" : "info@arm.com"
    },
    "mfa_status" : "enforced",
    "password_policy" : {
      "minimum_length" : "8"
    },
    "end_market" : "IT",
    "parent_id" : "01619571dad80242ac12000600000000",
    "sub_accounts" : [ "" ],
    "etag" : "1",
    "phone_number" : "+44 (1223) 400 400",
    "template_id" : "01619571e7160242ac12000600000000",
    "postal_code" : "CB1 9NJ",
    "object" : "account",
    "status" : "ACTIVE"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation AccountInfoList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
get /v3/accounts/{account_id}/policy-groups/{group_id}/api-keys
Get API keys of a group. Show more Show less

An endpoint for listing the API keys of the group with details.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/policy-groups/{group_id}/api-keys -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
group_id (required)
Path Parameter — The ID of the group whose API keys are retrieved.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "owner" : "01619571e2e89242ac12000600000000",
    "creation_time" : 1518630727683,
    "last_login_time" : 1518630727688,
    "created_at" : "2018-02-13T09:35:20Z",
    "groups" : [ "aeiou" ],
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "name" : "API key gorgon",
    "etag" : "1",
    "id" : "01619571f7020242ac12000600000000",
    "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
    "object" : "api-key",
    "status" : "ACTIVE"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation ApiKeyInfoRespList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or a group with that ID does not exist. ErrorResponse
get /v3/accounts/{account_id}/api-keys/{apikey_id}/groups
Get groups of the API key. Show more Show less

An endpoint for retrieving groups of the API key.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/api-keys/{apikey_id}/groups -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
apikey_id (required)
Path Parameter — The ID of the API key whose details are retrieved.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "apikey_count" : 0,
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "user_count" : 1,
    "name" : "Administrators",
    "created_at" : "2018-02-13T09:35:20Z",
    "etag" : "1",
    "id" : "01619571dec00242ac12000600000000",
    "object" : "group"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. GroupSummaryList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or an API key with the specified ID does not exist ErrorResponse
get /v3/accounts/{account_id}/users/{user_id}/groups
Get groups of the user. Show more Show less

An endpoint for retrieving groups of the user.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/users/{user_id}/groups -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
user_id (required)
Path Parameter — The ID of the user whose details are retrieved.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "apikey_count" : 0,
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "user_count" : 1,
    "name" : "Administrators",
    "created_at" : "2018-02-13T09:35:20Z",
    "etag" : "1",
    "id" : "01619571dec00242ac12000600000000",
    "object" : "group"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. GroupSummaryList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or a user with the specified ID does not exist. ErrorResponse
get /v3/accounts/{account_id}/policy-groups/{group_id}/users
Get users of a group. Show more Show less

An endpoint for listing users of the group with details.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/policy-groups/{group_id}/users -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
group_id (required)
Path Parameter — The ID of the group whose users are retrieved.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
status__eq (optional)
Query Parameter — An optional filter for getting users by status.
status__in (optional)
Query Parameter — An optional filter for getting users with a specified set of statuses.
status__nin (optional)
Query Parameter — An optional filter for excluding users with a specified set of statuses.
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "creation_time" : 1518630727683,
    "address" : "110 Fulbourn Rd, Cambridge, United Kingdom",
    "email_verified" : true,
    "last_login_time" : 1518630727688,
    "password_changed_time" : 1518630727688,
    "is_marketing_accepted" : true,
    "created_at" : "2018-02-13T09:35:20Z",
    "groups" : [ "aeiou" ],
    "is_gtc_accepted" : true,
    "is_totp_enabled" : true,
    "password" : "PZf9eEUH43DAPE9ULINFeuj",
    "full_name" : "User Doe",
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "login_history" : [ {
      "date" : "2018-02-14T17:52:07Z",
      "success" : true,
      "ip_address" : "127.0.0.1",
      "user_agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2227.1 Safari/537.36"
    } ],
    "etag" : "1",
    "phone_number" : "+44 (1223) 400 400",
    "id" : "01619571e2e89242ac12000600000000",
    "email" : "user@arm.com",
    "login_profiles" : [ {
      "name" : "aeiou",
      "id" : "aeiou",
      "type" : "NATIVE"
    } ],
    "object" : "user",
    "status" : "ACTIVE",
    "username" : "admin"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UserInfoRespList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or a group with that ID does not exist. ErrorResponse
delete /v3/accounts/{account_id}/api-keys/{apikey_id}/groups
Remove API key from groups. Show more Show less

An endpoint for removing API key from groups.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/api-keys/{apikey_id}/groups -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
apikey_id (required)
Path Parameter — The ID of the API key to be removed from the group.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body string (required)
Body Parameter — A list of IDs of the groups to be updated.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or an API key with the specified ID does not exist ErrorResponse
delete /v3/accounts/{account_id}/users/{user_id}/groups
Remove user from groups. Show more Show less

An endpoint for removing user from groups.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/users/{user_id}/groups -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
user_id (required)
Path Parameter — The ID of the user to be removed from the group.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body string (required)
Body Parameter — A list of IDs of the groups to be updated.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account, a user or a group with that ID does not exist. ErrorResponse
delete /v3/accounts/{account_id}/policy-groups/{group_id}/api-keys
Remove API keys from a group. Show more Show less

An endpoint for removing API keys from groups.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/policy-groups/{group_id}/api-keys -d '{"apikeys": ["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
group_id (required)
Path Parameter — The ID of the group from which the API keys are to be removed.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body SubjectList (required)
Body Parameter — A list of API keys to be removed from the group.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data, for example the array of API keys is missing. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or a group with that ID does not exist. ErrorResponse
delete /v3/accounts/{account_id}/policy-groups/{group_id}/users
Remove users from a group. Show more Show less

An endpoint for removing users from groups.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/policy-groups/{group_id}/users -d '{"users": ["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
group_id (required)
Path Parameter — The ID of the group from which the users are to be removed.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body SubjectList (required)
Body Parameter — A list of users to be removed from the group.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data, for example the last user to be removed from Administrators group. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or a group with that ID does not exist. ErrorResponse
post /v3/accounts/{account_id}/api-keys/{apikey_id}/reset-secret
Reset the secret key. Show more Show less

An endpoint for resetting the secret key of the API key.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/api-keys/{apikey_id}/reset-secret -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
apikey_id (required)
Path Parameter — The ID of the API key to be reset.
Return type
Example data
Content-Type: application/json
{
  "owner" : "01619571e2e89242ac12000600000000",
  "creation_time" : 1518630727683,
  "last_login_time" : 1518630727688,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "name" : "API key gorgon",
  "etag" : "1",
  "id" : "01619571f7020242ac12000600000000",
  "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
  "object" : "api-key",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation ApiKeyInfoResp
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or API key with the specified ID does not exist. ErrorResponse
put /v3/accounts/{account_id}
Update attributes of an existing account. Show more Show less

An endpoint for updating an account.

Example usage: curl -X PUT https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id} -d '{"phone_number": "12345678"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — The ID of the account to be updated.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body AccountUpdateRootReq (required)
Body Parameter — Details of the account to be updated.
Return type
Example data
Content-Type: application/json
{
  "country" : "United Kingdom",
  "reason" : "Subscription paid.",
  "aliases" : [ "aeiou" ],
  "city" : "Cambridge",
  "customer_number" : "1NC25_0001",
  "policies" : [ {
    "allow" : true,
    "feature" : "update-campaigns",
    "resource" : "/v3/update-campaign",
    "inherited" : false,
    "action" : "GET"
  } ],
  "sales_contact" : "sales@arm.com",
  "created_at" : "2018-02-13T09:35:20Z",
  "expiration_warning_threshold" : "180",
  "updated_at" : "2018-02-14T15:24:14Z",
  "address_line2" : " ",
  "tier" : "1",
  "address_line1" : "110 Fulbourn Rd",
  "contract_number" : "1NX25_0001",
  "contact" : "J. Doe",
  "reference_note" : "ARM-INT-0001",
  "company" : "ARM Holdings Plc",
  "id" : "01619571e2e90242ac12000600000000",
  "state" : " ",
  "idle_timeout" : "30",
  "email" : "info@arm.com",
  "limits" : {
    "key" : "aeiou"
  },
  "upgraded_at" : "2018-02-14T15:24:14Z",
  "custom_fields" : {
    "key" : "aeiou"
  },
  "display_name" : "ARM",
  "notification_emails" : [ "aeiou" ],
  "parent_account" : {
    "id" : "01619571dad80242ac12000600000000",
    "admin_name" : "J. Doe",
    "admin_email" : "info@arm.com"
  },
  "mfa_status" : "enforced",
  "password_policy" : {
    "minimum_length" : "8"
  },
  "end_market" : "IT",
  "parent_id" : "01619571dad80242ac12000600000000",
  "sub_accounts" : [ "" ],
  "etag" : "1",
  "phone_number" : "+44 (1223) 400 400",
  "template_id" : "01619571e7160242ac12000600000000",
  "postal_code" : "CB1 9NJ",
  "object" : "account",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation AccountInfo
400 Error in input data format. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 Account with the given ID not found. ErrorResponse
put /v3/accounts/{account_id}/api-keys/{apikey_id}
Update API key details. Show more Show less

An endpoint for updating API key details.

Example usage: curl -X PUT https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/api-keys/{apikey_id} -d '{"name": "TestApiKey25"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
apikey_id (required)
Path Parameter — The ID of the API key to be updated.
Request body
body ApiKeyUpdateReq (required)
Body Parameter — New API key attributes to be stored.
Return type
Example data
Content-Type: application/json
{
  "owner" : "01619571e2e89242ac12000600000000",
  "creation_time" : 1518630727683,
  "last_login_time" : 1518630727688,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "name" : "API key gorgon",
  "etag" : "1",
  "id" : "01619571f7020242ac12000600000000",
  "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
  "object" : "api-key",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation ApiKeyInfoResp
400 Error in input data, for example missing display name. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account ID or API key with the specified ID does not exist. ErrorResponse
put /v3/accounts/{account_id}/trusted-certificates/{cert_id}
Update trusted certificate. Show more Show less

An endpoint for updating existing trusted certificates.

Example usage: curl -X PUT https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/trusted-certificates/{cert_id} -d {"description": "very important cert"} -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
cert_id (required)
Path Parameter — The ID of the trusted certificate to be updated.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
Body Parameter — A trusted certificate object with attributes.
Return type
Example data
Content-Type: application/json
{
  "enrollment_mode" : false,
  "owner_id" : "01619571dad80242ac12000600000000",
  "subject" : "CN=subject",
  "certificate" : "-----BEGIN CERTIFICATE----- ... -----END CERTIFICATE-----",
  "created_at" : "2018-02-13T09:35:20Z",
  "description" : "Certificate created by me.",
  "device_execution_mode" : 1,
  "private_key" : "MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmE...",
  "issuer" : "CN=issuer",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "service" : "lwm2m",
  "name" : "My certificate",
  "etag" : "1",
  "id" : "01619571d01d0242ac12000600000000",
  "validity" : "2038-02-14T15:24:14Z",
  "object" : "trusted-cert",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation TrustedCertificateInternalResp
400 Invalid certificate data, certificate validation failed, certificate already expired or certificate uses unsupported, weak cipher. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden, only available for admins of commercial accounts. ErrorResponse
404 An account or certificate with the given ID does not exist. ErrorResponse
put /v3/accounts/{account_id}/policy-groups/{group_id}
Update the group name. Show more Show less

An endpoint for updating a group name.

Example usage: curl -X PUT https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/policy-groups/{group_id}/ -d '{"name": "TestGroup2"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
group_id (required)
Path Parameter — The ID of the group to be updated.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body GroupUpdateInfo (required)
Body Parameter — Details of the group to be created.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data, for example the group name is too long. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A group with that ID does not exist. ErrorResponse
put /v3/accounts/{account_id}/users/{user_id}
Update user details. Show more Show less

An endpoint for updating user details.

Example usage: curl -X PUT https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/users/{user_id} -d '{"username": "myusername"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
user_id (required)
Path Parameter — The ID of the user to be updated.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body UserUpdateReq (required)
Body Parameter — A user object with attributes.
Return type
Example data
Content-Type: application/json
{
  "creation_time" : 1518630727683,
  "address" : "110 Fulbourn Rd, Cambridge, United Kingdom",
  "email_verified" : true,
  "last_login_time" : 1518630727688,
  "password_changed_time" : 1518630727688,
  "is_marketing_accepted" : true,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "is_gtc_accepted" : true,
  "is_totp_enabled" : true,
  "password" : "PZf9eEUH43DAPE9ULINFeuj",
  "full_name" : "User Doe",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "login_history" : [ {
    "date" : "2018-02-14T17:52:07Z",
    "success" : true,
    "ip_address" : "127.0.0.1",
    "user_agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2227.1 Safari/537.36"
  } ],
  "etag" : "1",
  "phone_number" : "+44 (1223) 400 400",
  "id" : "01619571e2e89242ac12000600000000",
  "email" : "user@arm.com",
  "login_profiles" : [ {
    "name" : "aeiou",
    "id" : "aeiou",
    "type" : "NATIVE"
  } ],
  "object" : "user",
  "status" : "ACTIVE",
  "username" : "admin"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UserInfoResp
400 Error in input data, for example an invalid email address. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or a user with the given ID does not exist. ErrorResponse
409 A user with the given username or email already exists. ErrorResponse
post /v3/accounts/{account_id}/users/{user_id}/validate-email
Validate the user email. Show more Show less

An endpoint for validating the user email.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/accounts/{account_id}/users/{user_id}/validate-email -H 'Authorization: Bearer API_KEY'

Path parameters
account_id (required)
Path Parameter — Account ID.
user_id (required)
Path Parameter — The ID of the user whose email is validated.
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
204 Email validation successfully requested.
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 An account or a user with the specified ID does not exist. ErrorResponse

Developer

post /v3/api-keys/me/groups
Add API key to a list of groups. Show more Show less

An endpoint for adding API key to groups.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/api-keys/me/groups -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body string (required)
Body Parameter — A list of IDs of the groups to be updated.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
409 The API key is a member of the group already. ErrorResponse
post /v3/api-keys
Create a new API key. Show more Show less

An endpoint for creating a new API key.

Example usage: curl -X POST https://api.us-east-1.mbedcloud.com/v3/api-keys -d '{"name": "MyKey1"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body ApiKeyInfoReq (required)
Body Parameter — The details of the API key to be created.
Return type
Example data
Content-Type: application/json
{
  "owner" : "01619571e2e89242ac12000600000000",
  "creation_time" : 1518630727683,
  "last_login_time" : 1518630727688,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "name" : "API key gorgon",
  "etag" : "1",
  "id" : "01619571f7020242ac12000600000000",
  "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
  "object" : "api-key",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
201 New entity created. ApiKeyInfoResp
400 Error in input data, for example missing display name. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
delete /v3/api-keys/{apikey_id}
Delete API key. Show more Show less

An endpoint for deleting the API key.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/api-keys/{apikey_id} -H 'Authorization: Bearer API_KEY'

Path parameters
apikey_id (required)
Path Parameter — The ID of the API key to be deleted.
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
204 Deleted successfully.
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 The API key with the specified ID does not exist. ErrorResponse
delete /v3/trusted-certificates/{cert_id}
Delete a trusted certificate by ID. Show more Show less

An endpoint for deleting a trusted certificate.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/trusted-certificates/{cert_id} -H 'Authorization: Bearer API_KEY'

Path parameters
cert_id (required)
Path Parameter — The ID of the trusted certificate to be deleted.
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
204 Deleted successfully.
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 Certificate not found. ErrorResponse
get /v3/api-keys
Get all API keys Show more Show less

An endpoint for retrieving API keys in an array, optionally filtered by the owner.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/api-keys -H 'Authorization: Bearer API_KEY'

Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
key__eq (optional)
Query Parameter — API key filter. Do not include the private part of the API key (the last 32 characters).
owner__eq (optional)
Query Parameter — Owner name filter.
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "owner" : "01619571e2e89242ac12000600000000",
    "creation_time" : 1518630727683,
    "last_login_time" : 1518630727688,
    "created_at" : "2018-02-13T09:35:20Z",
    "groups" : [ "aeiou" ],
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "name" : "API key gorgon",
    "etag" : "1",
    "id" : "01619571f7020242ac12000600000000",
    "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
    "object" : "api-key",
    "status" : "ACTIVE"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. ApiKeyInfoRespList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
get /v3/trusted-certificates
Get all trusted certificates. Show more Show less

An endpoint for retrieving trusted certificates in an array.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/trusted-certificates -H 'Authorization: Bearer API_KEY'

Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
name__eq (optional)
Query Parameter — Filter for certificate name
service__eq (optional)
Query Parameter — Service filter, either lwm2m or bootstrap
expire__eq (optional)
Query Parameter — Expire filter in days format: int32
device_execution_mode__eq (optional)
Query Parameter — Device execution mode, as 1 for developer certificates or as another natural integer value format: int32
device_execution_mode__neq (optional)
Query Parameter — Device execution mode not equals filter format: int32
owner__eq (optional)
Query Parameter — Owner name filter
enrollment_mode__eq (optional)
Query Parameter — Enrollment mode filter
status__eq (optional)
Query Parameter — Filter for certificate status
issuer__like (optional)
Query Parameter — Issuer filter. Finds all matches where the filter value is a case insensitive substring of the result. Example: issuer__like=cn=iss matches CN=issuer.
subject__like (optional)
Query Parameter — Subject filter. Finds all matches where the filter value is a case insensitive substring of the result. Example: subject__like=cn=su matches CN=subject.
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "enrollment_mode" : false,
    "owner_id" : "01619571dad80242ac12000600000000",
    "subject" : "CN=subject",
    "certificate" : "-----BEGIN CERTIFICATE----- ... -----END CERTIFICATE-----",
    "created_at" : "2018-02-13T09:35:20Z",
    "description" : "Certificate created by me.",
    "device_execution_mode" : 1,
    "issuer" : "CN=issuer",
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "service" : "lwm2m",
    "name" : "My certificate",
    "etag" : "1",
    "id" : "01619571d01d0242ac12000600000000",
    "validity" : "2038-02-14T15:24:14Z",
    "object" : "trusted-cert",
    "status" : "ACTIVE"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation TrustedCertificateRespList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
get /v3/policy-groups
Get all group information. Show more Show less

An endpoint for retrieving all group information.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/policy-groups -H 'Authorization: Bearer API_KEY'

Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
name__eq (optional)
Query Parameter — Filter for group name
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "apikey_count" : 0,
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "user_count" : 1,
    "name" : "Administrators",
    "created_at" : "2018-02-13T09:35:20Z",
    "etag" : "1",
    "id" : "01619571dec00242ac12000600000000",
    "object" : "group"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. GroupSummaryList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
get /v3/api-keys/{apikey_id}
Get API key details. Show more Show less

An endpoint for retrieving API key details.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/api-keys/{apikey_id} -H 'Authorization: Bearer API_KEY'

Path parameters
apikey_id (required)
Path Parameter — The ID of the API key to be retrieved.
Return type
Example data
Content-Type: application/json
{
  "owner" : "01619571e2e89242ac12000600000000",
  "creation_time" : 1518630727683,
  "last_login_time" : 1518630727688,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "name" : "API key gorgon",
  "etag" : "1",
  "id" : "01619571f7020242ac12000600000000",
  "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
  "object" : "api-key",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. ApiKeyInfoResp
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 API key with the specified ID does not exist. ErrorResponse
get /v3/policy-groups/{group_id}/api-keys
Get the API keys of a group. Show more Show less

An endpoint for listing the API keys of the group with details.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/policy-groups/{group_id}/api-keys -H 'Authorization: Bearer API_KEY'

Path parameters
group_id (required)
Path Parameter — The ID of the group whose API keys are retrieved.
Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "owner" : "01619571e2e89242ac12000600000000",
    "creation_time" : 1518630727683,
    "last_login_time" : 1518630727688,
    "created_at" : "2018-02-13T09:35:20Z",
    "groups" : [ "aeiou" ],
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "name" : "API key gorgon",
    "etag" : "1",
    "id" : "01619571f7020242ac12000600000000",
    "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
    "object" : "api-key",
    "status" : "ACTIVE"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. ApiKeyInfoRespList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A group with that ID does not exist. ErrorResponse
get /v3/trusted-certificates/{cert_id}
Get trusted certificate by ID. Show more Show less

An endpoint for retrieving a trusted certificate by ID.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/trusted-certificates/{cert_id} -H 'Authorization: Bearer API_KEY'

Path parameters
cert_id (required)
Path Parameter — The ID of the trusted certificate to be retrieved.
Return type
Example data
Content-Type: application/json
{
  "enrollment_mode" : false,
  "owner_id" : "01619571dad80242ac12000600000000",
  "subject" : "CN=subject",
  "certificate" : "-----BEGIN CERTIFICATE----- ... -----END CERTIFICATE-----",
  "created_at" : "2018-02-13T09:35:20Z",
  "description" : "Certificate created by me.",
  "device_execution_mode" : 1,
  "issuer" : "CN=issuer",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "service" : "lwm2m",
  "name" : "My certificate",
  "etag" : "1",
  "id" : "01619571d01d0242ac12000600000000",
  "validity" : "2038-02-14T15:24:14Z",
  "object" : "trusted-cert",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation TrustedCertificateResp
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 Certificate not found. ErrorResponse
get /v3/policy-groups/{group_id}
Get group information. Show more Show less

An endpoint for getting general information about the group.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/policy-groups/{group_id} -H 'Authorization: Bearer API_KEY'

Path parameters
group_id (required)
Path Parameter — The ID of the group to be retrieved.
Return type
Example data
Content-Type: application/json
{
  "apikey_count" : 0,
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "user_count" : 1,
  "name" : "Administrators",
  "created_at" : "2018-02-13T09:35:20Z",
  "etag" : "1",
  "id" : "01619571dec00242ac12000600000000",
  "object" : "group"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. GroupSummary
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A group with that ID does not exist. ErrorResponse
get /v3/api-keys/me/groups
Get groups of the API key. Show more Show less

An endpoint for retrieving groups of the API key.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/api-keys/me/groups -H 'Authorization: Bearer API_KEY'

Query parameters
limit (optional)
Query Parameter — The number of results to return (2-1000), default is 50. default: 50 format: int32
after (optional)
Query Parameter — The entity ID to fetch after the given one.
order (optional)
Query Parameter — The order of the records based on creation time, ASC or DESC; by default ASC default: ASC
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: total_count
Return type
Example data
Content-Type: application/json
{
  "data" : [ {
    "apikey_count" : 0,
    "account_id" : "01619571e2e90242ac12000600000000",
    "updated_at" : "2018-02-14T15:24:14Z",
    "user_count" : 1,
    "name" : "Administrators",
    "created_at" : "2018-02-13T09:35:20Z",
    "etag" : "1",
    "id" : "01619571dec00242ac12000600000000",
    "object" : "group"
  } ],
  "total_count" : 20,
  "limit" : 50,
  "after" : "01619571f3c00242ac12000600000000",
  "has_more" : false,
  "object" : "list",
  "order" : "ASC"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. GroupSummaryList
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
get /v3/accounts/me
Get account info. Show more Show less

Returns detailed information about the account.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/accounts/me?include=policies -H 'Authorization: Bearer API_KEY'.

Query parameters
include (optional)
Query Parameter — Comma separated additional data to return. Currently supported: limits, policies, sub_accounts.
properties (optional)
Query Parameter — Property name to be returned from account specific properties.
Return type
Example data
Content-Type: application/json
{
  "country" : "United Kingdom",
  "reason" : "Subscription paid.",
  "aliases" : [ "aeiou" ],
  "city" : "Cambridge",
  "customer_number" : "1NC25_0001",
  "policies" : [ {
    "allow" : true,
    "feature" : "update-campaigns",
    "resource" : "/v3/update-campaign",
    "inherited" : false,
    "action" : "GET"
  } ],
  "sales_contact" : "sales@arm.com",
  "created_at" : "2018-02-13T09:35:20Z",
  "expiration_warning_threshold" : "180",
  "updated_at" : "2018-02-14T15:24:14Z",
  "address_line2" : " ",
  "tier" : "1",
  "address_line1" : "110 Fulbourn Rd",
  "contract_number" : "1NX25_0001",
  "contact" : "J. Doe",
  "reference_note" : "ARM-INT-0001",
  "company" : "ARM Holdings Plc",
  "id" : "01619571e2e90242ac12000600000000",
  "state" : " ",
  "idle_timeout" : "30",
  "email" : "info@arm.com",
  "limits" : {
    "key" : "aeiou"
  },
  "upgraded_at" : "2018-02-14T15:24:14Z",
  "custom_fields" : {
    "key" : "aeiou"
  },
  "display_name" : "ARM",
  "notification_emails" : [ "aeiou" ],
  "parent_account" : {
    "id" : "01619571dad80242ac12000600000000",
    "admin_name" : "J. Doe",
    "admin_email" : "info@arm.com"
  },
  "mfa_status" : "enforced",
  "password_policy" : {
    "minimum_length" : "8"
  },
  "end_market" : "IT",
  "parent_id" : "01619571dad80242ac12000600000000",
  "sub_accounts" : [ "" ],
  "etag" : "1",
  "phone_number" : "+44 (1223) 400 400",
  "template_id" : "01619571e7160242ac12000600000000",
  "postal_code" : "CB1 9NJ",
  "object" : "account",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. AccountInfo
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
get /v3/api-keys/me
Get API key details. Show more Show less

An endpoint for retrieving API key details.

Example usage: curl https://api.us-east-1.mbedcloud.com/v3/api-keys/me -H 'Authorization: Bearer API_KEY'

Return type
Example data
Content-Type: application/json
{
  "owner" : "01619571e2e89242ac12000600000000",
  "creation_time" : 1518630727683,
  "last_login_time" : 1518630727688,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "name" : "API key gorgon",
  "etag" : "1",
  "id" : "01619571f7020242ac12000600000000",
  "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
  "object" : "api-key",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation ApiKeyInfoResp
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
delete /v3/policy-groups/{group_id}/api-keys
Remove API keys from a group. Show more Show less

An endpoint for removing API keys from groups.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/policy-groups/{group_id}/api-keys -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
group_id (required)
Path Parameter — The ID of the group whose API keys are removed.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body SubjectList (required)
Body Parameter — A list of API keys to be removed from the group.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data, for example the array of API keys is missing. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 A group with that ID does not exist. ErrorResponse
delete /v3/api-keys/me/groups
Remove API key from groups. Show more Show less

An endpoint for removing API key from groups.

Example usage: curl -X DELETE https://api.us-east-1.mbedcloud.com/v3/api-keys/me/groups -d '["0162056a9a1586f30242590700000000","0117056a9a1586f30242590700000000"]' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
body string (required)
Body Parameter — A list of IDs of the groups to be updated.
Return type
Example data
Content-Type: application/json
{
  "code" : 200,
  "id" : "01619571dad80242ac12000600000000",
  "type" : "success",
  "message" : "success",
  "request_id" : "0161991d63150242ac12000600000000",
  "object" : "user"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation UpdatedResponse
400 Error in input data. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
put /v3/api-keys/{apikey_id}
Update API key details. Show more Show less

An endpoint for updating API key details.

Example usage: curl -X PUT https://api.us-east-1.mbedcloud.com/v3/api-keys/{apikey_id} -d '{"name": "TestApiKey25"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
apikey_id (required)
Path Parameter — The ID of the API key to be updated.
Request body
body ApiKeyUpdateReq (required)
Body Parameter — New API key attributes to be stored.
Return type
Example data
Content-Type: application/json
{
  "owner" : "01619571e2e89242ac12000600000000",
  "creation_time" : 1518630727683,
  "last_login_time" : 1518630727688,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "name" : "API key gorgon",
  "etag" : "1",
  "id" : "01619571f7020242ac12000600000000",
  "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
  "object" : "api-key",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Successful operation. ApiKeyInfoResp
400 Error in input data, for example missing display name. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 The API key with the specified ID does not exist. ErrorResponse
put /v3/trusted-certificates/{cert_id}
Update trusted certificate. Show more Show less

An endpoint for updating existing trusted certificates.

Example usage: curl -X PUT https://api.us-east-1.mbedcloud.com/v3/trusted-certificates/{cert_id} -d {"description": "very important cert"} -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Path parameters
cert_id (required)
Path Parameter — The ID of the trusted certificate to be updated.
Consumes
This API call consumes the following media types via the Content-Type request header:
  • application/json
Request body
Body Parameter — A trusted certificate object with attributes.
Return type
Example data
Content-Type: application/json
{
  "enrollment_mode" : false,
  "owner_id" : "01619571dad80242ac12000600000000",
  "subject" : "CN=subject",
  "certificate" : "-----BEGIN CERTIFICATE----- ... -----END CERTIFICATE-----",
  "created_at" : "2018-02-13T09:35:20Z",
  "description" : "Certificate created by me.",
  "device_execution_mode" : 1,
  "issuer" : "CN=issuer",
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "service" : "lwm2m",
  "name" : "My certificate",
  "etag" : "1",
  "id" : "01619571d01d0242ac12000600000000",
  "validity" : "2038-02-14T15:24:14Z",
  "object" : "trusted-cert",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation TrustedCertificateResp
400 Invalid certificate data or missing/invalid parameters. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse
404 Certificate not found. ErrorResponse
409 Certificate with the given name or subject already exists. ErrorResponse
put /v3/api-keys/me
Update API key details. Show more Show less

An endpoint for updating API key details.

Example usage: curl -X PUT https://api.us-east-1.mbedcloud.com/v3/api-keys/me -d '{"name": "TestApiKey25"}' -H 'content-type: application/json' -H 'Authorization: Bearer API_KEY'

Request body
body ApiKeyUpdateReq (required)
Body Parameter — New API key attributes to be stored.
Return type
Example data
Content-Type: application/json
{
  "owner" : "01619571e2e89242ac12000600000000",
  "creation_time" : 1518630727683,
  "last_login_time" : 1518630727688,
  "created_at" : "2018-02-13T09:35:20Z",
  "groups" : [ "aeiou" ],
  "account_id" : "01619571e2e90242ac12000600000000",
  "updated_at" : "2018-02-14T15:24:14Z",
  "name" : "API key gorgon",
  "etag" : "1",
  "id" : "01619571f7020242ac12000600000000",
  "key" : "ak_1MDE2MTk1NzFmNmU4MDI0MmFjMTIwMDA2MDAwMDAwMDA01619571f7020242ac12000600000000",
  "object" : "api-key",
  "status" : "ACTIVE"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 successful operation ApiKeyInfoResp
400 Error in input data, for example missing display name. ErrorResponse
401 Authentication failure. ErrorResponse
403 Forbidden. ErrorResponse

DeveloperCertificate

get /v3/developer-certificates/{muuid}
Fetch an existing developer certificate to connect to the bootstrap server. Show more Show less

This REST API is intended to be used by customers to fetch an existing developer certificate (a certificate that can be flashed into multiple devices to connect to bootstrap server).

Example usage: curl -X GET "http://api.us-east-1.mbedcloud.com/v3/developer-certificates/THE_CERTIFICATE_ID" -H "accept: application/json" -H "Authorization: Bearer THE_ACCESS_TOKEN"

Path parameters
muuid (required)
Path Parameter — A unique identifier for the developer certificate.
Request headers
Return type
Example data
Content-Type: Success
{
  "object" : "trusted-cert",
  "id" : "015fee4431fd38c98640fbfb00000000",
  "etag" : "1",
  "created_at" : "2017-12-11T14:22:20.009Z",
  "account_id" : "015fee5d9b3538c98640fbfb00000000",
  "name" : "DeveloperCertificate",
  "description" : "This certificate will be used with multiple developer devices",
  "developer_certificate" : "-----BEGIN CERTIFICATE-----\\nMIICcDCCAhWgAwIBAgIRAPSBbBtLUE/ekQcWE4GzPJEwCgYIKoZIzj0EAwIwgaIx\\nCzAJBgNVBAYTAkdCMRcwFQYDVQQIDA5DYW1icmlkZ2VzaGlyZTESMBAGA1UEBwwJ\\nQ2FtYnJpZGdlMRAwDgYDVQQKDAdBUk0gTHRkMSkwJwYDVQQLDCAwMTU4NDNlMzJl\\nYzkwMjQyMGEwMTVlMDcwMDAwMDAwMDEpMCcGA1UEAwwgMDE2MWRiYmNkZDY2MGE1\\nODBhMDEwYzM0MDNjMDAwMDAwHhcNMTgwMjI4MDkyNzIzWhcNMjgwMjI4MDkyNzIz\\nWjCBojELMAkGA1UEBhMCR0IxFzAVBgNVBAgMDkNhbWJyaWRnZXNoaXJlMRIwEAYD\\nVQQHDAlDYW1icmlkZ2UxEDAOBgNVBAoMB0FSTSBMdGQxKTAnBgNVBAsMIDAxNTg0\\nM2UzMmVjOTAyNDIwYTAxNWUwNzAwMDAwMDAwMSkwJwYDVQQDDCAwMTYxZGJiY2Rk\\nNjYwYTU4MGEwMTBjMzQwM2MwMDAwMDBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IA\\nBEScLDbOXvOb903AYlI9ow8E4hbLSHJPt5E2BO4Q4bHOpuWH2Oh6P+CDPte9pAv3\\nE6g90Xk/ZcZpQ+xBO6qci/ajKjAoMBIGCSsGAQQBoCCBSQQFAgNAAJEwEgYDVR0T\\nAQH/BAgwBgEB/wIBADAKBggqhkjOPQQDAgNJADBGAiEAsi9zSK8Njl22GoEHrsg8\\nQlwFnrkkP9d6FyLFtmqndt4CIQCmVHwisYNcCkqD2SWctG1xQHo0HZePAQW8PstM\\nzhNupQ==\\n-----END CERTIFICATE-----\\n",
  "developer_private_key" : "-----BEGIN PRIVATE KEY-----\\nMIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgeKc97aC1Z4aniXVG\\njNSvvXw2hl6zwACYIs88OKQx61GgCgYIKoZIzj0DAQehRANCAAREnCw2zl7zm/dN\\nwGJSPaMPBOIWy0hyT7eRNgTuEOGxzqblh9joej/ggz7XvaQL9xOoPdF5P2XGaUPs\\nQTuqnIv2\\n-----END PRIVATE KEY-----\\n",
  "security_file_content" : "/*\\n * Copyright (c) 2017 ARM Limited. All rights reserved.\\n * SPDX-License-Identifier: Apache-2.0\\n * Licensed under the Apache License, Version 2.0 (the License); you may\\n * not use this file except in compliance with the License.\\n * You may obtain a copy of the License at\\n *\\n * http://www.apache.org/licenses/LICENSE-2.0\\n *\\n * Unless required by applicable law or agreed to in writing, software\\n * distributed under the License is distributed on an AS IS BASIS, WITHOUT\\n * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\\n * See the License for the specific language governing permissions and\\n * limitations under the License.\\n */\\n#ifndef __MBED_CLOUD_DEV_CREDENTIALS_H__\\n#define __MBED_CLOUD_DEV_CREDENTIALS_H__\\n\\n#include \\n\\nconst char MBED_CLOUD_DEV_BOOTSTRAP_ENDPOINT_NAME[] = \\\"0161dbbcdd660a580a010c3403c00000\\\";\\nconst char MBED_CLOUD_DEV_ACCOUNT_ID[] = \\\"015843e32ec902420a015e0700000000\\\";\\nconst char MBED_CLOUD_DEV_BOOTSTRAP_SERVER_URI[] = \\\"coaps://coap.us-east-1.mbedcloud.com:5684?aid=015843e32ec902420a015e0700000000\\\";\\n\\nconst uint8_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_CERTIFICATE[] = \\n{ 0x30, 0x82, 0x02, 0x70, 0x30, 0x82, 0x02, 0x15,\\n 0xa0, 0x03, 0x02, 0x01, 0x02, 0x02, 0x11, 0x00,\\n 0xf4, 0x81, 0x6c, 0x1b, 0x4b, 0x50, 0x4f, 0xde,\\n 0x91, 0x07, 0x16, 0x13, 0x81, 0xb3, 0x3c, 0x91,\\n 0x30, 0x0a, 0x06, 0x08, 0x2a, 0x86, 0x48, 0xce,\\n 0x3d, 0x04, 0x03, 0x02, 0x30, 0x81, 0xa2, 0x31,\\n 0x0b, 0x30, 0x09, 0x06, 0x03, 0x55, 0x04, 0x06,\\n 0x13, 0x02, 0x47, 0x42, 0x31, 0x17, 0x30, 0x15,\\n 0x06, 0x03, 0x55, 0x04, 0x08, 0x0c, 0x0e, 0x43,\\n 0x61, 0x6d, 0x62, 0x72, 0x69, 0x64, 0x67, 0x65,\\n 0x73, 0x68, 0x69, 0x72, 0x65, 0x31, 0x12, 0x30,\\n 0x10, 0x06, 0x03, 0x55, 0x04, 0x07, 0x0c, 0x09,\\n 0x43, 0x61, 0x6d, 0x62, 0x72, 0x69, 0x64, 0x67,\\n 0x65, 0x31, 0x10, 0x30, 0x0e, 0x06, 0x03, 0x55,\\n 0x04, 0x0a, 0x0c, 0x07, 0x41, 0x52, 0x4d, 0x20,\\n 0x4c, 0x74, 0x64, 0x31, 0x29, 0x30, 0x27, 0x06,\\n 0x03, 0x55, 0x04, 0x0b, 0x0c, 0x20, 0x30, 0x31,\\n 0x35, 0x38, 0x34, 0x33, 0x65, 0x33, 0x32, 0x65,\\n 0x63, 0x39, 0x30, 0x32, 0x34, 0x32, 0x30, 0x61,\\n 0x30, 0x31, 0x35, 0x65, 0x30, 0x37, 0x30, 0x30,\\n 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x31, 0x29,\\n 0x30, 0x27, 0x06, 0x03, 0x55, 0x04, 0x03, 0x0c,\\n 0x20, 0x30, 0x31, 0x36, 0x31, 0x64, 0x62, 0x62,\\n 0x63, 0x64, 0x64, 0x36, 0x36, 0x30, 0x61, 0x35,\\n 0x38, 0x30, 0x61, 0x30, 0x31, 0x30, 0x63, 0x33,\\n 0x34, 0x30, 0x33, 0x63, 0x30, 0x30, 0x30, 0x30,\\n 0x30, 0x30, 0x1e, 0x17, 0x0d, 0x31, 0x38, 0x30,\\n 0x32, 0x32, 0x38, 0x30, 0x39, 0x32, 0x37, 0x32,\\n 0x33, 0x5a, 0x17, 0x0d, 0x32, 0x38, 0x30, 0x32,\\n 0x32, 0x38, 0x30, 0x39, 0x32, 0x37, 0x32, 0x33,\\n 0x5a, 0x30, 0x81, 0xa2, 0x31, 0x0b, 0x30, 0x09,\\n 0x06, 0x03, 0x55, 0x04, 0x06, 0x13, 0x02, 0x47,\\n 0x42, 0x31, 0x17, 0x30, 0x15, 0x06, 0x03, 0x55,\\n 0x04, 0x08, 0x0c, 0x0e, 0x43, 0x61, 0x6d, 0x62,\\n 0x72, 0x69, 0x64, 0x67, 0x65, 0x73, 0x68, 0x69,\\n 0x72, 0x65, 0x31, 0x12, 0x30, 0x10, 0x06, 0x03,\\n 0x55, 0x04, 0x07, 0x0c, 0x09, 0x43, 0x61, 0x6d,\\n 0x62, 0x72, 0x69, 0x64, 0x67, 0x65, 0x31, 0x10,\\n 0x30, 0x0e, 0x06, 0x03, 0x55, 0x04, 0x0a, 0x0c,\\n 0x07, 0x41, 0x52, 0x4d, 0x20, 0x4c, 0x74, 0x64,\\n 0x31, 0x29, 0x30, 0x27, 0x06, 0x03, 0x55, 0x04,\\n 0x0b, 0x0c, 0x20, 0x30, 0x31, 0x35, 0x38, 0x34,\\n 0x33, 0x65, 0x33, 0x32, 0x65, 0x63, 0x39, 0x30,\\n 0x32, 0x34, 0x32, 0x30, 0x61, 0x30, 0x31, 0x35,\\n 0x65, 0x30, 0x37, 0x30, 0x30, 0x30, 0x30, 0x30,\\n 0x30, 0x30, 0x30, 0x31, 0x29, 0x30, 0x27, 0x06,\\n 0x03, 0x55, 0x04, 0x03, 0x0c, 0x20, 0x30, 0x31,\\n 0x36, 0x31, 0x64, 0x62, 0x62, 0x63, 0x64, 0x64,\\n 0x36, 0x36, 0x30, 0x61, 0x35, 0x38, 0x30, 0x61,\\n 0x30, 0x31, 0x30, 0x63, 0x33, 0x34, 0x30, 0x33,\\n 0x63, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x59,\\n 0x30, 0x13, 0x06, 0x07, 0x2a, 0x86, 0x48, 0xce,\\n 0x3d, 0x02, 0x01, 0x06, 0x08, 0x2a, 0x86, 0x48,\\n 0xce, 0x3d, 0x03, 0x01, 0x07, 0x03, 0x42, 0x00,\\n 0x04, 0x44, 0x9c, 0x2c, 0x36, 0xce, 0x5e, 0xf3,\\n 0x9b, 0xf7, 0x4d, 0xc0, 0x62, 0x52, 0x3d, 0xa3,\\n 0x0f, 0x04, 0xe2, 0x16, 0xcb, 0x48, 0x72, 0x4f,\\n 0xb7, 0x91, 0x36, 0x04, 0xee, 0x10, 0xe1, 0xb1,\\n 0xce, 0xa6, 0xe5, 0x87, 0xd8, 0xe8, 0x7a, 0x3f,\\n 0xe0, 0x83, 0x3e, 0xd7, 0xbd, 0xa4, 0x0b, 0xf7,\\n 0x13, 0xa8, 0x3d, 0xd1, 0x79, 0x3f, 0x65, 0xc6,\\n 0x69, 0x43, 0xec, 0x41, 0x3b, 0xaa, 0x9c, 0x8b,\\n 0xf6, 0xa3, 0x2a, 0x30, 0x28, 0x30, 0x12, 0x06,\\n 0x09, 0x2b, 0x06, 0x01, 0x04, 0x01, 0xa0, 0x20,\\n 0x81, 0x49, 0x04, 0x05, 0x02, 0x03, 0x40, 0x00,\\n 0x91, 0x30, 0x12, 0x06, 0x03, 0x55, 0x1d, 0x13,\\n 0x01, 0x01, 0xff, 0x04, 0x08, 0x30, 0x06, 0x01,\\n 0x01, 0xff, 0x02, 0x01, 0x00, 0x30, 0x0a, 0x06,\\n 0x08, 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x04, 0x03,\\n 0x02, 0x03, 0x49, 0x00, 0x30, 0x46, 0x02, 0x21,\\n 0x00, 0xb2, 0x2f, 0x73, 0x48, 0xaf, 0x0d, 0x8e,\\n 0x5d, 0xb6, 0x1a, 0x81, 0x07, 0xae, 0xc8, 0x3c,\\n 0x42, 0x5c, 0x05, 0x9e, 0xb9, 0x24, 0x3f, 0xd7,\\n 0x7a, 0x17, 0x22, 0xc5, 0xb6, 0x6a, 0xa7, 0x76,\\n 0xde, 0x02, 0x21, 0x00, 0xa6, 0x54, 0x7c, 0x22,\\n 0xb1, 0x83, 0x5c, 0x0a, 0x4a, 0x83, 0xd9, 0x25,\\n 0x9c, 0xb4, 0x6d, 0x71, 0x40, 0x7a, 0x34, 0x1d,\\n 0x97, 0x8f, 0x01, 0x05, 0xbc, 0x3e, 0xcb, 0x4c,\\n 0xce, 0x13, 0x6e, 0xa5 };\\n\\nconst uint8_t MBED_CLOUD_DEV_BOOTSTRAP_SERVER_ROOT_CA_CERTIFICATE[] = \\n{ 0x30, 0x82, 0x02, 0x35, 0x30, 0x82, 0x01, 0xdb,\\n 0xa0, 0x03, 0x02, 0x01, 0x02, 0x02, 0x10, 0x5c,\\n 0x27, 0xa5, 0x76, 0x7d, 0x58, 0x85, 0x8a, 0x43,\\n 0x91, 0xa0, 0x61, 0xab, 0xcf, 0xa6, 0x59, 0x30,\\n 0x0a, 0x06, 0x08, 0x2a, 0x86, 0x48, 0xce, 0x3d,\\n 0x04, 0x03, 0x02, 0x30, 0x72, 0x31, 0x0b, 0x30,\\n 0x09, 0x06, 0x03, 0x55, 0x04, 0x06, 0x13, 0x02,\\n 0x47, 0x42, 0x31, 0x17, 0x30, 0x15, 0x06, 0x03,\\n 0x55, 0x04, 0x08, 0x13, 0x0e, 0x43, 0x61, 0x6d,\\n 0x62, 0x72, 0x69, 0x64, 0x67, 0x65, 0x73, 0x68,\\n 0x69, 0x72, 0x65, 0x31, 0x12, 0x30, 0x10, 0x06,\\n 0x03, 0x55, 0x04, 0x07, 0x13, 0x09, 0x43, 0x61,\\n 0x6d, 0x62, 0x72, 0x69, 0x64, 0x67, 0x65, 0x31,\\n 0x10, 0x30, 0x0e, 0x06, 0x03, 0x55, 0x04, 0x0a,\\n 0x13, 0x07, 0x41, 0x52, 0x4d, 0x20, 0x4c, 0x74,\\n 0x64, 0x31, 0x24, 0x30, 0x22, 0x06, 0x03, 0x55,\\n 0x04, 0x03, 0x13, 0x1b, 0x41, 0x52, 0x4d, 0x20,\\n 0x49, 0x6e, 0x74, 0x65, 0x67, 0x72, 0x61, 0x74,\\n 0x69, 0x6f, 0x6e, 0x20, 0x42, 0x6f, 0x6f, 0x74,\\n 0x73, 0x74, 0x72, 0x61, 0x70, 0x43, 0x41, 0x30,\\n 0x20, 0x17, 0x0d, 0x31, 0x37, 0x30, 0x35, 0x31,\\n 0x35, 0x31, 0x39, 0x34, 0x39, 0x31, 0x31, 0x5a,\\n 0x18, 0x0f, 0x32, 0x30, 0x35, 0x32, 0x30, 0x35,\\n 0x31, 0x35, 0x31, 0x39, 0x35, 0x39, 0x31, 0x30,\\n 0x5a, 0x30, 0x72, 0x31, 0x0b, 0x30, 0x09, 0x06,\\n 0x03, 0x55, 0x04, 0x06, 0x13, 0x02, 0x47, 0x42,\\n 0x31, 0x17, 0x30, 0x15, 0x06, 0x03, 0x55, 0x04,\\n 0x08, 0x13, 0x0e, 0x43, 0x61, 0x6d, 0x62, 0x72,\\n 0x69, 0x64, 0x67, 0x65, 0x73, 0x68, 0x69, 0x72,\\n 0x65, 0x31, 0x12, 0x30, 0x10, 0x06, 0x03, 0x55,\\n 0x04, 0x07, 0x13, 0x09, 0x43, 0x61, 0x6d, 0x62,\\n 0x72, 0x69, 0x64, 0x67, 0x65, 0x31, 0x10, 0x30,\\n 0x0e, 0x06, 0x03, 0x55, 0x04, 0x0a, 0x13, 0x07,\\n 0x41, 0x52, 0x4d, 0x20, 0x4c, 0x74, 0x64, 0x31,\\n 0x24, 0x30, 0x22, 0x06, 0x03, 0x55, 0x04, 0x03,\\n 0x13, 0x1b, 0x41, 0x52, 0x4d, 0x20, 0x49, 0x6e,\\n 0x74, 0x65, 0x67, 0x72, 0x61, 0x74, 0x69, 0x6f,\\n 0x6e, 0x20, 0x42, 0x6f, 0x6f, 0x74, 0x73, 0x74,\\n 0x72, 0x61, 0x70, 0x43, 0x41, 0x30, 0x59, 0x30,\\n 0x13, 0x06, 0x07, 0x2a, 0x86, 0x48, 0xce, 0x3d,\\n 0x02, 0x01, 0x06, 0x08, 0x2a, 0x86, 0x48, 0xce,\\n 0x3d, 0x03, 0x01, 0x07, 0x03, 0x42, 0x00, 0x04,\\n 0x8b, 0x7c, 0x86, 0xc3, 0x88, 0x54, 0xe6, 0x5f,\\n 0xe0, 0x57, 0x4e, 0x1b, 0xac, 0x29, 0x82, 0xea,\\n 0x7d, 0x91, 0x00, 0x63, 0xa7, 0x4a, 0x05, 0xbc,\\n 0x54, 0xc5, 0x71, 0x27, 0x33, 0x19, 0x1b, 0x2e,\\n 0xfa, 0x41, 0xf8, 0x7a, 0x9a, 0x0c, 0x5d, 0xfc,\\n 0xb3, 0x37, 0x01, 0x99, 0xc5, 0xc9, 0xbe, 0x78,\\n 0x5b, 0x1d, 0xec, 0xb0, 0x1a, 0x1d, 0xdc, 0xe4,\\n 0x6f, 0x57, 0x04, 0xf4, 0x3a, 0xca, 0xa8, 0xd2,\\n 0xa3, 0x51, 0x30, 0x4f, 0x30, 0x0b, 0x06, 0x03,\\n 0x55, 0x1d, 0x0f, 0x04, 0x04, 0x03, 0x02, 0x01,\\n 0x86, 0x30, 0x0f, 0x06, 0x03, 0x55, 0x1d, 0x13,\\n 0x01, 0x01, 0xff, 0x04, 0x05, 0x30, 0x03, 0x01,\\n 0x01, 0xff, 0x30, 0x1d, 0x06, 0x03, 0x55, 0x1d,\\n 0x0e, 0x04, 0x16, 0x04, 0x14, 0x13, 0xef, 0x69,\\n 0xfa, 0x62, 0x3f, 0x00, 0x86, 0xf4, 0x05, 0xb8,\\n 0xb6, 0xe6, 0xb2, 0xf1, 0xdb, 0x69, 0x10, 0xb4,\\n 0x39, 0x30, 0x10, 0x06, 0x09, 0x2b, 0x06, 0x01,\\n 0x04, 0x01, 0x82, 0x37, 0x15, 0x01, 0x04, 0x03,\\n 0x02, 0x01, 0x00, 0x30, 0x0a, 0x06, 0x08, 0x2a,\\n 0x86, 0x48, 0xce, 0x3d, 0x04, 0x03, 0x02, 0x03,\\n 0x48, 0x00, 0x30, 0x45, 0x02, 0x21, 0x00, 0xa2,\\n 0x50, 0x88, 0x0f, 0x55, 0xe8, 0x26, 0x49, 0xe6,\\n 0xf5, 0x71, 0x86, 0x33, 0x29, 0x05, 0x4c, 0xf9,\\n 0xfd, 0x1f, 0x14, 0x98, 0x92, 0x85, 0xd9, 0x5c,\\n 0x48, 0x02, 0x9e, 0xc2, 0x79, 0xa8, 0x59, 0x02,\\n 0x20, 0x3e, 0xfe, 0x3c, 0xa0, 0xbf, 0xd3, 0x0f,\\n 0x15, 0x83, 0x56, 0xbc, 0xf2, 0xfa, 0x16, 0x26,\\n 0x7a, 0xc1, 0x68, 0xaa, 0xbc, 0x91, 0x3c, 0x69,\\n 0x44, 0x36, 0xf9, 0x74, 0xa1, 0x82, 0x76, 0x7a,\\n 0x6e };\\n\\nconst uint8_t MBED_CLOUD_DEV_LWM2M_SERVER_ROOT_CA_CERTIFICATE[] = \\n{ 0x30, 0x82, 0x02, 0x30, 0x30, 0x82, 0x01, 0xd5,\\n 0xa0, 0x03, 0x02, 0x01, 0x02, 0x02, 0x10, 0x26,\\n 0xf9, 0x08, 0xfc, 0xf1, 0xc0, 0x46, 0xa4, 0x4a,\\n 0x4d, 0x2c, 0xf1, 0x94, 0x27, 0xf9, 0x1f, 0x30,\\n 0x0a, 0x06, 0x08, 0x2a, 0x86, 0x48, 0xce, 0x3d,\\n 0x04, 0x03, 0x02, 0x30, 0x6f, 0x31, 0x0b, 0x30,\\n 0x09, 0x06, 0x03, 0x55, 0x04, 0x06, 0x13, 0x02,\\n 0x47, 0x42, 0x31, 0x17, 0x30, 0x15, 0x06, 0x03,\\n 0x55, 0x04, 0x08, 0x13, 0x0e, 0x43, 0x61, 0x6d,\\n 0x62, 0x72, 0x69, 0x64, 0x67, 0x65, 0x73, 0x68,\\n 0x69, 0x72, 0x65, 0x31, 0x12, 0x30, 0x10, 0x06,\\n 0x03, 0x55, 0x04, 0x07, 0x13, 0x09, 0x43, 0x61,\\n 0x6d, 0x62, 0x72, 0x69, 0x64, 0x67, 0x65, 0x31,\\n 0x10, 0x30, 0x0e, 0x06, 0x03, 0x55, 0x04, 0x0a,\\n 0x13, 0x07, 0x41, 0x52, 0x4d, 0x20, 0x4c, 0x74,\\n 0x64, 0x31, 0x21, 0x30, 0x1f, 0x06, 0x03, 0x55,\\n 0x04, 0x03, 0x13, 0x18, 0x41, 0x52, 0x4d, 0x20,\\n 0x49, 0x6e, 0x74, 0x65, 0x67, 0x72, 0x61, 0x74,\\n 0x69, 0x6f, 0x6e, 0x20, 0x4c, 0x57, 0x4d, 0x32,\\n 0x4d, 0x20, 0x43, 0x41, 0x30, 0x20, 0x17, 0x0d,\\n 0x31, 0x37, 0x30, 0x32, 0x31, 0x32, 0x31, 0x30,\\n 0x33, 0x37, 0x35, 0x32, 0x5a, 0x18, 0x0f, 0x32,\\n 0x30, 0x35, 0x32, 0x30, 0x32, 0x31, 0x32, 0x31,\\n 0x30, 0x34, 0x37, 0x35, 0x32, 0x5a, 0x30, 0x6f,\\n 0x31, 0x0b, 0x30, 0x09, 0x06, 0x03, 0x55, 0x04,\\n 0x06, 0x13, 0x02, 0x47, 0x42, 0x31, 0x17, 0x30,\\n 0x15, 0x06, 0x03, 0x55, 0x04, 0x08, 0x13, 0x0e,\\n 0x43, 0x61, 0x6d, 0x62, 0x72, 0x69, 0x64, 0x67,\\n 0x65, 0x73, 0x68, 0x69, 0x72, 0x65, 0x31, 0x12,\\n 0x30, 0x10, 0x06, 0x03, 0x55, 0x04, 0x07, 0x13,\\n 0x09, 0x43, 0x61, 0x6d, 0x62, 0x72, 0x69, 0x64,\\n 0x67, 0x65, 0x31, 0x10, 0x30, 0x0e, 0x06, 0x03,\\n 0x55, 0x04, 0x0a, 0x13, 0x07, 0x41, 0x52, 0x4d,\\n 0x20, 0x4c, 0x74, 0x64, 0x31, 0x21, 0x30, 0x1f,\\n 0x06, 0x03, 0x55, 0x04, 0x03, 0x13, 0x18, 0x41,\\n 0x52, 0x4d, 0x20, 0x49, 0x6e, 0x74, 0x65, 0x67,\\n 0x72, 0x61, 0x74, 0x69, 0x6f, 0x6e, 0x20, 0x4c,\\n 0x57, 0x4d, 0x32, 0x4d, 0x20, 0x43, 0x41, 0x30,\\n 0x59, 0x30, 0x13, 0x06, 0x07, 0x2a, 0x86, 0x48,\\n 0xce, 0x3d, 0x02, 0x01, 0x06, 0x08, 0x2a, 0x86,\\n 0x48, 0xce, 0x3d, 0x03, 0x01, 0x07, 0x03, 0x42,\\n 0x00, 0x04, 0xba, 0xea, 0x80, 0x01, 0x2d, 0xf0,\\n 0xe1, 0xb6, 0xc5, 0x5f, 0xf9, 0x76, 0x84, 0x31,\\n 0xa9, 0x29, 0xa1, 0xc7, 0xa8, 0xfd, 0xa0, 0xad,\\n 0xd9, 0x94, 0xe7, 0xec, 0x5a, 0x33, 0xa1, 0x2c,\\n 0x8e, 0x36, 0x43, 0x9b, 0x18, 0xdf, 0xce, 0x71,\\n 0x14, 0x24, 0xb1, 0xfb, 0x16, 0x34, 0x0e, 0x43,\\n 0xfc, 0x23, 0x77, 0xd4, 0x13, 0xd7, 0x11, 0xaa,\\n 0x39, 0x60, 0xab, 0xa2, 0xdf, 0x24, 0xb3, 0xeb,\\n 0xa0, 0xc5, 0xa3, 0x51, 0x30, 0x4f, 0x30, 0x0b,\\n 0x06, 0x03, 0x55, 0x1d, 0x0f, 0x04, 0x04, 0x03,\\n 0x02, 0x01, 0x86, 0x30, 0x0f, 0x06, 0x03, 0x55,\\n 0x1d, 0x13, 0x01, 0x01, 0xff, 0x04, 0x05, 0x30,\\n 0x03, 0x01, 0x01, 0xff, 0x30, 0x1d, 0x06, 0x03,\\n 0x55, 0x1d, 0x0e, 0x04, 0x16, 0x04, 0x14, 0x7b,\\n 0xa1, 0xa5, 0x94, 0xa5, 0xe5, 0x8f, 0x95, 0x5d,\\n 0xd4, 0xce, 0xdc, 0x0f, 0x8a, 0xbe, 0xad, 0x9a,\\n 0x6b, 0x66, 0x3e, 0x30, 0x10, 0x06, 0x09, 0x2b,\\n 0x06, 0x01, 0x04, 0x01, 0x82, 0x37, 0x15, 0x01,\\n 0x04, 0x03, 0x02, 0x01, 0x00, 0x30, 0x0a, 0x06,\\n 0x08, 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x04, 0x03,\\n 0x02, 0x03, 0x49, 0x00, 0x30, 0x46, 0x02, 0x21,\\n 0x00, 0xd2, 0x06, 0x28, 0xc5, 0x31, 0x3a, 0x11,\\n 0x8d, 0xb6, 0xcb, 0x2b, 0x3f, 0xdd, 0x2a, 0x9a,\\n 0x13, 0x30, 0x52, 0x77, 0xaa, 0xda, 0xda, 0xcb,\\n 0xce, 0xb9, 0x5c, 0xe4, 0x32, 0x1c, 0x02, 0xfa,\\n 0x30, 0x02, 0x21, 0x00, 0xb3, 0x82, 0x24, 0xa2,\\n 0xb1, 0x67, 0x6b, 0x69, 0x07, 0x0e, 0xcd, 0x77,\\n 0x74, 0x99, 0x06, 0x9c, 0x59, 0xb2, 0x00, 0xc0,\\n 0xb3, 0xbb, 0x37, 0x5b, 0xc0, 0x1b, 0xfb, 0xd9,\\n 0x70, 0x98, 0xb9, 0x1e };\\n\\nconst uint8_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_PRIVATE_KEY[] = \\n{ 0x30, 0x81, 0x93, 0x02, 0x01, 0x00, 0x30, 0x13,\\n 0x06, 0x07, 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x02,\\n 0x01, 0x06, 0x08, 0x2a, 0x86, 0x48, 0xce, 0x3d,\\n 0x03, 0x01, 0x07, 0x04, 0x79, 0x30, 0x77, 0x02,\\n 0x01, 0x01, 0x04, 0x20, 0x78, 0xa7, 0x3d, 0xed,\\n 0xa0, 0xb5, 0x67, 0x86, 0xa7, 0x89, 0x75, 0x46,\\n 0x8c, 0xd4, 0xaf, 0xbd, 0x7c, 0x36, 0x86, 0x5e,\\n 0xb3, 0xc0, 0x00, 0x98, 0x22, 0xcf, 0x3c, 0x38,\\n 0xa4, 0x31, 0xeb, 0x51, 0xa0, 0x0a, 0x06, 0x08,\\n 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x03, 0x01, 0x07,\\n 0xa1, 0x44, 0x03, 0x42, 0x00, 0x04, 0x44, 0x9c,\\n 0x2c, 0x36, 0xce, 0x5e, 0xf3, 0x9b, 0xf7, 0x4d,\\n 0xc0, 0x62, 0x52, 0x3d, 0xa3, 0x0f, 0x04, 0xe2,\\n 0x16, 0xcb, 0x48, 0x72, 0x4f, 0xb7, 0x91, 0x36,\\n 0x04, 0xee, 0x10, 0xe1, 0xb1, 0xce, 0xa6, 0xe5,\\n 0x87, 0xd8, 0xe8, 0x7a, 0x3f, 0xe0, 0x83, 0x3e,\\n 0xd7, 0xbd, 0xa4, 0x0b, 0xf7, 0x13, 0xa8, 0x3d,\\n 0xd1, 0x79, 0x3f, 0x65, 0xc6, 0x69, 0x43, 0xec,\\n 0x41, 0x3b, 0xaa, 0x9c, 0x8b, 0xf6 };\\n\\nconst char MBED_CLOUD_DEV_MANUFACTURER[] = \\\"dev_manufacturer\\\";\\n\\nconst char MBED_CLOUD_DEV_MODEL_NUMBER[] = \\\"dev_model_num\\\";\\n\\nconst char MBED_CLOUD_DEV_SERIAL_NUMBER[] = \\\"0\\\";\\n\\nconst char MBED_CLOUD_DEV_DEVICE_TYPE[] = \\\"dev_device_type\\\";\\n\\nconst char MBED_CLOUD_DEV_HARDWARE_VERSION[] = \\\"dev_hardware_version\\\";\\n\\nconst uint32_t MBED_CLOUD_DEV_MEMORY_TOTAL_KB = 0;\\n\\nconst uint32_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_CERTIFICATE_SIZE = sizeof(MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_CERTIFICATE);\\nconst uint32_t MBED_CLOUD_DEV_BOOTSTRAP_SERVER_ROOT_CA_CERTIFICATE_SIZE = sizeof(MBED_CLOUD_DEV_BOOTSTRAP_SERVER_ROOT_CA_CERTIFICATE);\\nconst uint32_t MBED_CLOUD_DEV_LWM2M_SERVER_ROOT_CA_CERTIFICATE_SIZE = sizeof(MBED_CLOUD_DEV_LWM2M_SERVER_ROOT_CA_CERTIFICATE);\\nconst uint32_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_PRIVATE_KEY_SIZE = sizeof(MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_PRIVATE_KEY);\\n\\n#endif //__MBED_CLOUD_DEV_CREDENTIALS_H__\\n"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Developer certificate fetched successfully. DeveloperCertificateResponseData
400 Bad request. ErrorResponse
401 The provided access token is not valid. ErrorResponse
404 Developer certificate not found with given id. ErrorResponse
post /v3/developer-certificates
Create a new developer certificate to connect to the bootstrap server. Show more Show less

This REST API is intended to be used by customers to get a developer certificate (a certificate that can be flashed into multiple devices to connect to bootstrap server).

Note: The number of developer certificates allowed per account is limited. Please see Using your own certificate authority.

Example usage: curl -X POST "http://api.us-east-1.mbedcloud.com/v3/developer-certificates" -H "accept: application/json" -H "Authorization: Bearer THE_ACCESS_TOKEN" -H "content-type: application/json" -d "{ "name": "THE_CERTIFICATE_NAME", "description": "THE_CERTIFICATE_DESCRIPTION"}"

Request body
Body Parameter
Request headers
Return type
Example data
Content-Type: Success
{
  "object" : "trusted-cert",
  "id" : "015fee4431fd38c98640fbfb00000000",
  "etag" : "1",
  "created_at" : "2017-12-11T14:22:20.009Z",
  "account_id" : "015fee5d9b3538c98640fbfb00000000",
  "name" : "DeveloperCertificate",
  "description" : "This certificate will be used with multiple developer devices",
  "developer_certificate" : "-----BEGIN CERTIFICATE-----\\nMIICcDCCAhWgAwIBAgIRAPSBbBtLUE/ekQcWE4GzPJEwCgYIKoZIzj0EAwIwgaIx\\nCzAJBgNVBAYTAkdCMRcwFQYDVQQIDA5DYW1icmlkZ2VzaGlyZTESMBAGA1UEBwwJ\\nQ2FtYnJpZGdlMRAwDgYDVQQKDAdBUk0gTHRkMSkwJwYDVQQLDCAwMTU4NDNlMzJl\\nYzkwMjQyMGEwMTVlMDcwMDAwMDAwMDEpMCcGA1UEAwwgMDE2MWRiYmNkZDY2MGE1\\nODBhMDEwYzM0MDNjMDAwMDAwHhcNMTgwMjI4MDkyNzIzWhcNMjgwMjI4MDkyNzIz\\nWjCBojELMAkGA1UEBhMCR0IxFzAVBgNVBAgMDkNhbWJyaWRnZXNoaXJlMRIwEAYD\\nVQQHDAlDYW1icmlkZ2UxEDAOBgNVBAoMB0FSTSBMdGQxKTAnBgNVBAsMIDAxNTg0\\nM2UzMmVjOTAyNDIwYTAxNWUwNzAwMDAwMDAwMSkwJwYDVQQDDCAwMTYxZGJiY2Rk\\nNjYwYTU4MGEwMTBjMzQwM2MwMDAwMDBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IA\\nBEScLDbOXvOb903AYlI9ow8E4hbLSHJPt5E2BO4Q4bHOpuWH2Oh6P+CDPte9pAv3\\nE6g90Xk/ZcZpQ+xBO6qci/ajKjAoMBIGCSsGAQQBoCCBSQQFAgNAAJEwEgYDVR0T\\nAQH/BAgwBgEB/wIBADAKBggqhkjOPQQDAgNJADBGAiEAsi9zSK8Njl22GoEHrsg8\\nQlwFnrkkP9d6FyLFtmqndt4CIQCmVHwisYNcCkqD2SWctG1xQHo0HZePAQW8PstM\\nzhNupQ==\\n-----END CERTIFICATE-----\\n",
  "developer_private_key" : "-----BEGIN PRIVATE KEY-----\\nMIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgeKc97aC1Z4aniXVG\\njNSvvXw2hl6zwACYIs88OKQx61GgCgYIKoZIzj0DAQehRANCAAREnCw2zl7zm/dN\\nwGJSPaMPBOIWy0hyT7eRNgTuEOGxzqblh9joej/ggz7XvaQL9xOoPdF5P2XGaUPs\\nQTuqnIv2\\n-----END PRIVATE KEY-----\\n",
  "security_file_content" : "/*\\n * Copyright (c) 2017 ARM Limited. All rights reserved.\\n * SPDX-License-Identifier: Apache-2.0\\n * Licensed under the Apache License, Version 2.0 (the License); you may\\n * not use this file except in compliance with the License.\\n * You may obtain a copy of the License at\\n *\\n * http://www.apache.org/licenses/LICENSE-2.0\\n *\\n * Unless required by applicable law or agreed to in writing, software\\n * distributed under the License is distributed on an AS IS BASIS, WITHOUT\\n * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\\n * See the License for the specific language governing permissions and\\n * limitations under the License.\\n */\\n#ifndef __MBED_CLOUD_DEV_CREDENTIALS_H__\\n#define __MBED_CLOUD_DEV_CREDENTIALS_H__\\n\\n#include \\n\\nconst char MBED_CLOUD_DEV_BOOTSTRAP_ENDPOINT_NAME[] = \\\"0161dbbcdd660a580a010c3403c00000\\\";\\nconst char MBED_CLOUD_DEV_ACCOUNT_ID[] = \\\"015843e32ec902420a015e0700000000\\\";\\nconst char MBED_CLOUD_DEV_BOOTSTRAP_SERVER_URI[] = \\\"coaps://coap-integration-lab.dev.mbed.com:5684?aid=015843e32ec902420a015e0700000000\\\";\\n\\nconst uint8_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_CERTIFICATE[] = \\n{ 0x30, 0x82, 0x02, 0x70, 0x30, 0x82, 0x02, 0x15,\\n 0xa0, 0x03, 0x02, 0x01, 0x02, 0x02, 0x11, 0x00,\\n 0xf4, 0x81, 0x6c, 0x1b, 0x4b, 0x50, 0x4f, 0xde,\\n 0x91, 0x07, 0x16, 0x13, 0x81, 0xb3, 0x3c, 0x91,\\n 0x30, 0x0a, 0x06, 0x08, 0x2a, 0x86, 0x48, 0xce,\\n 0x3d, 0x04, 0x03, 0x02, 0x30, 0x81, 0xa2, 0x31,\\n 0x0b, 0x30, 0x09, 0x06, 0x03, 0x55, 0x04, 0x06,\\n 0x13, 0x02, 0x47, 0x42, 0x31, 0x17, 0x30, 0x15,\\n 0x06, 0x03, 0x55, 0x04, 0x08, 0x0c, 0x0e, 0x43,\\n 0x61, 0x6d, 0x62, 0x72, 0x69, 0x64, 0x67, 0x65,\\n 0x73, 0x68, 0x69, 0x72, 0x65, 0x31, 0x12, 0x30,\\n 0x10, 0x06, 0x03, 0x55, 0x04, 0x07, 0x0c, 0x09,\\n 0x43, 0x61, 0x6d, 0x62, 0x72, 0x69, 0x64, 0x67,\\n 0x65, 0x31, 0x10, 0x30, 0x0e, 0x06, 0x03, 0x55,\\n 0x04, 0x0a, 0x0c, 0x07, 0x41, 0x52, 0x4d, 0x20,\\n 0x4c, 0x74, 0x64, 0x31, 0x29, 0x30, 0x27, 0x06,\\n 0x03, 0x55, 0x04, 0x0b, 0x0c, 0x20, 0x30, 0x31,\\n 0x35, 0x38, 0x34, 0x33, 0x65, 0x33, 0x32, 0x65,\\n 0x63, 0x39, 0x30, 0x32, 0x34, 0x32, 0x30, 0x61,\\n 0x30, 0x31, 0x35, 0x65, 0x30, 0x37, 0x30, 0x30,\\n 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x31, 0x29,\\n 0x30, 0x27, 0x06, 0x03, 0x55, 0x04, 0x03, 0x0c,\\n 0x20, 0x30, 0x31, 0x36, 0x31, 0x64, 0x62, 0x62,\\n 0x63, 0x64, 0x64, 0x36, 0x36, 0x30, 0x61, 0x35,\\n 0x38, 0x30, 0x61, 0x30, 0x31, 0x30, 0x63, 0x33,\\n 0x34, 0x30, 0x33, 0x63, 0x30, 0x30, 0x30, 0x30,\\n 0x30, 0x30, 0x1e, 0x17, 0x0d, 0x31, 0x38, 0x30,\\n 0x32, 0x32, 0x38, 0x30, 0x39, 0x32, 0x37, 0x32,\\n 0x33, 0x5a, 0x17, 0x0d, 0x32, 0x38, 0x30, 0x32,\\n 0x32, 0x38, 0x30, 0x39, 0x32, 0x37, 0x32, 0x33,\\n 0x5a, 0x30, 0x81, 0xa2, 0x31, 0x0b, 0x30, 0x09,\\n 0x06, 0x03, 0x55, 0x04, 0x06, 0x13, 0x02, 0x47,\\n 0x42, 0x31, 0x17, 0x30, 0x15, 0x06, 0x03, 0x55,\\n 0x04, 0x08, 0x0c, 0x0e, 0x43, 0x61, 0x6d, 0x62,\\n 0x72, 0x69, 0x64, 0x67, 0x65, 0x73, 0x68, 0x69,\\n 0x72, 0x65, 0x31, 0x12, 0x30, 0x10, 0x06, 0x03,\\n 0x55, 0x04, 0x07, 0x0c, 0x09, 0x43, 0x61, 0x6d,\\n 0x62, 0x72, 0x69, 0x64, 0x67, 0x65, 0x31, 0x10,\\n 0x30, 0x0e, 0x06, 0x03, 0x55, 0x04, 0x0a, 0x0c,\\n 0x07, 0x41, 0x52, 0x4d, 0x20, 0x4c, 0x74, 0x64,\\n 0x31, 0x29, 0x30, 0x27, 0x06, 0x03, 0x55, 0x04,\\n 0x0b, 0x0c, 0x20, 0x30, 0x31, 0x35, 0x38, 0x34,\\n 0x33, 0x65, 0x33, 0x32, 0x65, 0x63, 0x39, 0x30,\\n 0x32, 0x34, 0x32, 0x30, 0x61, 0x30, 0x31, 0x35,\\n 0x65, 0x30, 0x37, 0x30, 0x30, 0x30, 0x30, 0x30,\\n 0x30, 0x30, 0x30, 0x31, 0x29, 0x30, 0x27, 0x06,\\n 0x03, 0x55, 0x04, 0x03, 0x0c, 0x20, 0x30, 0x31,\\n 0x36, 0x31, 0x64, 0x62, 0x62, 0x63, 0x64, 0x64,\\n 0x36, 0x36, 0x30, 0x61, 0x35, 0x38, 0x30, 0x61,\\n 0x30, 0x31, 0x30, 0x63, 0x33, 0x34, 0x30, 0x33,\\n 0x63, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x59,\\n 0x30, 0x13, 0x06, 0x07, 0x2a, 0x86, 0x48, 0xce,\\n 0x3d, 0x02, 0x01, 0x06, 0x08, 0x2a, 0x86, 0x48,\\n 0xce, 0x3d, 0x03, 0x01, 0x07, 0x03, 0x42, 0x00,\\n 0x04, 0x44, 0x9c, 0x2c, 0x36, 0xce, 0x5e, 0xf3,\\n 0x9b, 0xf7, 0x4d, 0xc0, 0x62, 0x52, 0x3d, 0xa3,\\n 0x0f, 0x04, 0xe2, 0x16, 0xcb, 0x48, 0x72, 0x4f,\\n 0xb7, 0x91, 0x36, 0x04, 0xee, 0x10, 0xe1, 0xb1,\\n 0xce, 0xa6, 0xe5, 0x87, 0xd8, 0xe8, 0x7a, 0x3f,\\n 0xe0, 0x83, 0x3e, 0xd7, 0xbd, 0xa4, 0x0b, 0xf7,\\n 0x13, 0xa8, 0x3d, 0xd1, 0x79, 0x3f, 0x65, 0xc6,\\n 0x69, 0x43, 0xec, 0x41, 0x3b, 0xaa, 0x9c, 0x8b,\\n 0xf6, 0xa3, 0x2a, 0x30, 0x28, 0x30, 0x12, 0x06,\\n 0x09, 0x2b, 0x06, 0x01, 0x04, 0x01, 0xa0, 0x20,\\n 0x81, 0x49, 0x04, 0x05, 0x02, 0x03, 0x40, 0x00,\\n 0x91, 0x30, 0x12, 0x06, 0x03, 0x55, 0x1d, 0x13,\\n 0x01, 0x01, 0xff, 0x04, 0x08, 0x30, 0x06, 0x01,\\n 0x01, 0xff, 0x02, 0x01, 0x00, 0x30, 0x0a, 0x06,\\n 0x08, 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x04, 0x03,\\n 0x02, 0x03, 0x49, 0x00, 0x30, 0x46, 0x02, 0x21,\\n 0x00, 0xb2, 0x2f, 0x73, 0x48, 0xaf, 0x0d, 0x8e,\\n 0x5d, 0xb6, 0x1a, 0x81, 0x07, 0xae, 0xc8, 0x3c,\\n 0x42, 0x5c, 0x05, 0x9e, 0xb9, 0x24, 0x3f, 0xd7,\\n 0x7a, 0x17, 0x22, 0xc5, 0xb6, 0x6a, 0xa7, 0x76,\\n 0xde, 0x02, 0x21, 0x00, 0xa6, 0x54, 0x7c, 0x22,\\n 0xb1, 0x83, 0x5c, 0x0a, 0x4a, 0x83, 0xd9, 0x25,\\n 0x9c, 0xb4, 0x6d, 0x71, 0x40, 0x7a, 0x34, 0x1d,\\n 0x97, 0x8f, 0x01, 0x05, 0xbc, 0x3e, 0xcb, 0x4c,\\n 0xce, 0x13, 0x6e, 0xa5 };\\n\\nconst uint8_t MBED_CLOUD_DEV_BOOTSTRAP_SERVER_ROOT_CA_CERTIFICATE[] = \\n{ 0x30, 0x82, 0x02, 0x35, 0x30, 0x82, 0x01, 0xdb,\\n 0xa0, 0x03, 0x02, 0x01, 0x02, 0x02, 0x10, 0x5c,\\n 0x27, 0xa5, 0x76, 0x7d, 0x58, 0x85, 0x8a, 0x43,\\n 0x91, 0xa0, 0x61, 0xab, 0xcf, 0xa6, 0x59, 0x30,\\n 0x0a, 0x06, 0x08, 0x2a, 0x86, 0x48, 0xce, 0x3d,\\n 0x04, 0x03, 0x02, 0x30, 0x72, 0x31, 0x0b, 0x30,\\n 0x09, 0x06, 0x03, 0x55, 0x04, 0x06, 0x13, 0x02,\\n 0x47, 0x42, 0x31, 0x17, 0x30, 0x15, 0x06, 0x03,\\n 0x55, 0x04, 0x08, 0x13, 0x0e, 0x43, 0x61, 0x6d,\\n 0x62, 0x72, 0x69, 0x64, 0x67, 0x65, 0x73, 0x68,\\n 0x69, 0x72, 0x65, 0x31, 0x12, 0x30, 0x10, 0x06,\\n 0x03, 0x55, 0x04, 0x07, 0x13, 0x09, 0x43, 0x61,\\n 0x6d, 0x62, 0x72, 0x69, 0x64, 0x67, 0x65, 0x31,\\n 0x10, 0x30, 0x0e, 0x06, 0x03, 0x55, 0x04, 0x0a,\\n 0x13, 0x07, 0x41, 0x52, 0x4d, 0x20, 0x4c, 0x74,\\n 0x64, 0x31, 0x24, 0x30, 0x22, 0x06, 0x03, 0x55,\\n 0x04, 0x03, 0x13, 0x1b, 0x41, 0x52, 0x4d, 0x20,\\n 0x49, 0x6e, 0x74, 0x65, 0x67, 0x72, 0x61, 0x74,\\n 0x69, 0x6f, 0x6e, 0x20, 0x42, 0x6f, 0x6f, 0x74,\\n 0x73, 0x74, 0x72, 0x61, 0x70, 0x43, 0x41, 0x30,\\n 0x20, 0x17, 0x0d, 0x31, 0x37, 0x30, 0x35, 0x31,\\n 0x35, 0x31, 0x39, 0x34, 0x39, 0x31, 0x31, 0x5a,\\n 0x18, 0x0f, 0x32, 0x30, 0x35, 0x32, 0x30, 0x35,\\n 0x31, 0x35, 0x31, 0x39, 0x35, 0x39, 0x31, 0x30,\\n 0x5a, 0x30, 0x72, 0x31, 0x0b, 0x30, 0x09, 0x06,\\n 0x03, 0x55, 0x04, 0x06, 0x13, 0x02, 0x47, 0x42,\\n 0x31, 0x17, 0x30, 0x15, 0x06, 0x03, 0x55, 0x04,\\n 0x08, 0x13, 0x0e, 0x43, 0x61, 0x6d, 0x62, 0x72,\\n 0x69, 0x64, 0x67, 0x65, 0x73, 0x68, 0x69, 0x72,\\n 0x65, 0x31, 0x12, 0x30, 0x10, 0x06, 0x03, 0x55,\\n 0x04, 0x07, 0x13, 0x09, 0x43, 0x61, 0x6d, 0x62,\\n 0x72, 0x69, 0x64, 0x67, 0x65, 0x31, 0x10, 0x30,\\n 0x0e, 0x06, 0x03, 0x55, 0x04, 0x0a, 0x13, 0x07,\\n 0x41, 0x52, 0x4d, 0x20, 0x4c, 0x74, 0x64, 0x31,\\n 0x24, 0x30, 0x22, 0x06, 0x03, 0x55, 0x04, 0x03,\\n 0x13, 0x1b, 0x41, 0x52, 0x4d, 0x20, 0x49, 0x6e,\\n 0x74, 0x65, 0x67, 0x72, 0x61, 0x74, 0x69, 0x6f,\\n 0x6e, 0x20, 0x42, 0x6f, 0x6f, 0x74, 0x73, 0x74,\\n 0x72, 0x61, 0x70, 0x43, 0x41, 0x30, 0x59, 0x30,\\n 0x13, 0x06, 0x07, 0x2a, 0x86, 0x48, 0xce, 0x3d,\\n 0x02, 0x01, 0x06, 0x08, 0x2a, 0x86, 0x48, 0xce,\\n 0x3d, 0x03, 0x01, 0x07, 0x03, 0x42, 0x00, 0x04,\\n 0x8b, 0x7c, 0x86, 0xc3, 0x88, 0x54, 0xe6, 0x5f,\\n 0xe0, 0x57, 0x4e, 0x1b, 0xac, 0x29, 0x82, 0xea,\\n 0x7d, 0x91, 0x00, 0x63, 0xa7, 0x4a, 0x05, 0xbc,\\n 0x54, 0xc5, 0x71, 0x27, 0x33, 0x19, 0x1b, 0x2e,\\n 0xfa, 0x41, 0xf8, 0x7a, 0x9a, 0x0c, 0x5d, 0xfc,\\n 0xb3, 0x37, 0x01, 0x99, 0xc5, 0xc9, 0xbe, 0x78,\\n 0x5b, 0x1d, 0xec, 0xb0, 0x1a, 0x1d, 0xdc, 0xe4,\\n 0x6f, 0x57, 0x04, 0xf4, 0x3a, 0xca, 0xa8, 0xd2,\\n 0xa3, 0x51, 0x30, 0x4f, 0x30, 0x0b, 0x06, 0x03,\\n 0x55, 0x1d, 0x0f, 0x04, 0x04, 0x03, 0x02, 0x01,\\n 0x86, 0x30, 0x0f, 0x06, 0x03, 0x55, 0x1d, 0x13,\\n 0x01, 0x01, 0xff, 0x04, 0x05, 0x30, 0x03, 0x01,\\n 0x01, 0xff, 0x30, 0x1d, 0x06, 0x03, 0x55, 0x1d,\\n 0x0e, 0x04, 0x16, 0x04, 0x14, 0x13, 0xef, 0x69,\\n 0xfa, 0x62, 0x3f, 0x00, 0x86, 0xf4, 0x05, 0xb8,\\n 0xb6, 0xe6, 0xb2, 0xf1, 0xdb, 0x69, 0x10, 0xb4,\\n 0x39, 0x30, 0x10, 0x06, 0x09, 0x2b, 0x06, 0x01,\\n 0x04, 0x01, 0x82, 0x37, 0x15, 0x01, 0x04, 0x03,\\n 0x02, 0x01, 0x00, 0x30, 0x0a, 0x06, 0x08, 0x2a,\\n 0x86, 0x48, 0xce, 0x3d, 0x04, 0x03, 0x02, 0x03,\\n 0x48, 0x00, 0x30, 0x45, 0x02, 0x21, 0x00, 0xa2,\\n 0x50, 0x88, 0x0f, 0x55, 0xe8, 0x26, 0x49, 0xe6,\\n 0xf5, 0x71, 0x86, 0x33, 0x29, 0x05, 0x4c, 0xf9,\\n 0xfd, 0x1f, 0x14, 0x98, 0x92, 0x85, 0xd9, 0x5c,\\n 0x48, 0x02, 0x9e, 0xc2, 0x79, 0xa8, 0x59, 0x02,\\n 0x20, 0x3e, 0xfe, 0x3c, 0xa0, 0xbf, 0xd3, 0x0f,\\n 0x15, 0x83, 0x56, 0xbc, 0xf2, 0xfa, 0x16, 0x26,\\n 0x7a, 0xc1, 0x68, 0xaa, 0xbc, 0x91, 0x3c, 0x69,\\n 0x44, 0x36, 0xf9, 0x74, 0xa1, 0x82, 0x76, 0x7a,\\n 0x6e };\\n\\nconst uint8_t MBED_CLOUD_DEV_LWM2M_SERVER_ROOT_CA_CERTIFICATE[] = \\n{ 0x30, 0x82, 0x02, 0x30, 0x30, 0x82, 0x01, 0xd5,\\n 0xa0, 0x03, 0x02, 0x01, 0x02, 0x02, 0x10, 0x26,\\n 0xf9, 0x08, 0xfc, 0xf1, 0xc0, 0x46, 0xa4, 0x4a,\\n 0x4d, 0x2c, 0xf1, 0x94, 0x27, 0xf9, 0x1f, 0x30,\\n 0x0a, 0x06, 0x08, 0x2a, 0x86, 0x48, 0xce, 0x3d,\\n 0x04, 0x03, 0x02, 0x30, 0x6f, 0x31, 0x0b, 0x30,\\n 0x09, 0x06, 0x03, 0x55, 0x04, 0x06, 0x13, 0x02,\\n 0x47, 0x42, 0x31, 0x17, 0x30, 0x15, 0x06, 0x03,\\n 0x55, 0x04, 0x08, 0x13, 0x0e, 0x43, 0x61, 0x6d,\\n 0x62, 0x72, 0x69, 0x64, 0x67, 0x65, 0x73, 0x68,\\n 0x69, 0x72, 0x65, 0x31, 0x12, 0x30, 0x10, 0x06,\\n 0x03, 0x55, 0x04, 0x07, 0x13, 0x09, 0x43, 0x61,\\n 0x6d, 0x62, 0x72, 0x69, 0x64, 0x67, 0x65, 0x31,\\n 0x10, 0x30, 0x0e, 0x06, 0x03, 0x55, 0x04, 0x0a,\\n 0x13, 0x07, 0x41, 0x52, 0x4d, 0x20, 0x4c, 0x74,\\n 0x64, 0x31, 0x21, 0x30, 0x1f, 0x06, 0x03, 0x55,\\n 0x04, 0x03, 0x13, 0x18, 0x41, 0x52, 0x4d, 0x20,\\n 0x49, 0x6e, 0x74, 0x65, 0x67, 0x72, 0x61, 0x74,\\n 0x69, 0x6f, 0x6e, 0x20, 0x4c, 0x57, 0x4d, 0x32,\\n 0x4d, 0x20, 0x43, 0x41, 0x30, 0x20, 0x17, 0x0d,\\n 0x31, 0x37, 0x30, 0x32, 0x31, 0x32, 0x31, 0x30,\\n 0x33, 0x37, 0x35, 0x32, 0x5a, 0x18, 0x0f, 0x32,\\n 0x30, 0x35, 0x32, 0x30, 0x32, 0x31, 0x32, 0x31,\\n 0x30, 0x34, 0x37, 0x35, 0x32, 0x5a, 0x30, 0x6f,\\n 0x31, 0x0b, 0x30, 0x09, 0x06, 0x03, 0x55, 0x04,\\n 0x06, 0x13, 0x02, 0x47, 0x42, 0x31, 0x17, 0x30,\\n 0x15, 0x06, 0x03, 0x55, 0x04, 0x08, 0x13, 0x0e,\\n 0x43, 0x61, 0x6d, 0x62, 0x72, 0x69, 0x64, 0x67,\\n 0x65, 0x73, 0x68, 0x69, 0x72, 0x65, 0x31, 0x12,\\n 0x30, 0x10, 0x06, 0x03, 0x55, 0x04, 0x07, 0x13,\\n 0x09, 0x43, 0x61, 0x6d, 0x62, 0x72, 0x69, 0x64,\\n 0x67, 0x65, 0x31, 0x10, 0x30, 0x0e, 0x06, 0x03,\\n 0x55, 0x04, 0x0a, 0x13, 0x07, 0x41, 0x52, 0x4d,\\n 0x20, 0x4c, 0x74, 0x64, 0x31, 0x21, 0x30, 0x1f,\\n 0x06, 0x03, 0x55, 0x04, 0x03, 0x13, 0x18, 0x41,\\n 0x52, 0x4d, 0x20, 0x49, 0x6e, 0x74, 0x65, 0x67,\\n 0x72, 0x61, 0x74, 0x69, 0x6f, 0x6e, 0x20, 0x4c,\\n 0x57, 0x4d, 0x32, 0x4d, 0x20, 0x43, 0x41, 0x30,\\n 0x59, 0x30, 0x13, 0x06, 0x07, 0x2a, 0x86, 0x48,\\n 0xce, 0x3d, 0x02, 0x01, 0x06, 0x08, 0x2a, 0x86,\\n 0x48, 0xce, 0x3d, 0x03, 0x01, 0x07, 0x03, 0x42,\\n 0x00, 0x04, 0xba, 0xea, 0x80, 0x01, 0x2d, 0xf0,\\n 0xe1, 0xb6, 0xc5, 0x5f, 0xf9, 0x76, 0x84, 0x31,\\n 0xa9, 0x29, 0xa1, 0xc7, 0xa8, 0xfd, 0xa0, 0xad,\\n 0xd9, 0x94, 0xe7, 0xec, 0x5a, 0x33, 0xa1, 0x2c,\\n 0x8e, 0x36, 0x43, 0x9b, 0x18, 0xdf, 0xce, 0x71,\\n 0x14, 0x24, 0xb1, 0xfb, 0x16, 0x34, 0x0e, 0x43,\\n 0xfc, 0x23, 0x77, 0xd4, 0x13, 0xd7, 0x11, 0xaa,\\n 0x39, 0x60, 0xab, 0xa2, 0xdf, 0x24, 0xb3, 0xeb,\\n 0xa0, 0xc5, 0xa3, 0x51, 0x30, 0x4f, 0x30, 0x0b,\\n 0x06, 0x03, 0x55, 0x1d, 0x0f, 0x04, 0x04, 0x03,\\n 0x02, 0x01, 0x86, 0x30, 0x0f, 0x06, 0x03, 0x55,\\n 0x1d, 0x13, 0x01, 0x01, 0xff, 0x04, 0x05, 0x30,\\n 0x03, 0x01, 0x01, 0xff, 0x30, 0x1d, 0x06, 0x03,\\n 0x55, 0x1d, 0x0e, 0x04, 0x16, 0x04, 0x14, 0x7b,\\n 0xa1, 0xa5, 0x94, 0xa5, 0xe5, 0x8f, 0x95, 0x5d,\\n 0xd4, 0xce, 0xdc, 0x0f, 0x8a, 0xbe, 0xad, 0x9a,\\n 0x6b, 0x66, 0x3e, 0x30, 0x10, 0x06, 0x09, 0x2b,\\n 0x06, 0x01, 0x04, 0x01, 0x82, 0x37, 0x15, 0x01,\\n 0x04, 0x03, 0x02, 0x01, 0x00, 0x30, 0x0a, 0x06,\\n 0x08, 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x04, 0x03,\\n 0x02, 0x03, 0x49, 0x00, 0x30, 0x46, 0x02, 0x21,\\n 0x00, 0xd2, 0x06, 0x28, 0xc5, 0x31, 0x3a, 0x11,\\n 0x8d, 0xb6, 0xcb, 0x2b, 0x3f, 0xdd, 0x2a, 0x9a,\\n 0x13, 0x30, 0x52, 0x77, 0xaa, 0xda, 0xda, 0xcb,\\n 0xce, 0xb9, 0x5c, 0xe4, 0x32, 0x1c, 0x02, 0xfa,\\n 0x30, 0x02, 0x21, 0x00, 0xb3, 0x82, 0x24, 0xa2,\\n 0xb1, 0x67, 0x6b, 0x69, 0x07, 0x0e, 0xcd, 0x77,\\n 0x74, 0x99, 0x06, 0x9c, 0x59, 0xb2, 0x00, 0xc0,\\n 0xb3, 0xbb, 0x37, 0x5b, 0xc0, 0x1b, 0xfb, 0xd9,\\n 0x70, 0x98, 0xb9, 0x1e };\\n\\nconst uint8_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_PRIVATE_KEY[] = \\n{ 0x30, 0x81, 0x93, 0x02, 0x01, 0x00, 0x30, 0x13,\\n 0x06, 0x07, 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x02,\\n 0x01, 0x06, 0x08, 0x2a, 0x86, 0x48, 0xce, 0x3d,\\n 0x03, 0x01, 0x07, 0x04, 0x79, 0x30, 0x77, 0x02,\\n 0x01, 0x01, 0x04, 0x20, 0x78, 0xa7, 0x3d, 0xed,\\n 0xa0, 0xb5, 0x67, 0x86, 0xa7, 0x89, 0x75, 0x46,\\n 0x8c, 0xd4, 0xaf, 0xbd, 0x7c, 0x36, 0x86, 0x5e,\\n 0xb3, 0xc0, 0x00, 0x98, 0x22, 0xcf, 0x3c, 0x38,\\n 0xa4, 0x31, 0xeb, 0x51, 0xa0, 0x0a, 0x06, 0x08,\\n 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x03, 0x01, 0x07,\\n 0xa1, 0x44, 0x03, 0x42, 0x00, 0x04, 0x44, 0x9c,\\n 0x2c, 0x36, 0xce, 0x5e, 0xf3, 0x9b, 0xf7, 0x4d,\\n 0xc0, 0x62, 0x52, 0x3d, 0xa3, 0x0f, 0x04, 0xe2,\\n 0x16, 0xcb, 0x48, 0x72, 0x4f, 0xb7, 0x91, 0x36,\\n 0x04, 0xee, 0x10, 0xe1, 0xb1, 0xce, 0xa6, 0xe5,\\n 0x87, 0xd8, 0xe8, 0x7a, 0x3f, 0xe0, 0x83, 0x3e,\\n 0xd7, 0xbd, 0xa4, 0x0b, 0xf7, 0x13, 0xa8, 0x3d,\\n 0xd1, 0x79, 0x3f, 0x65, 0xc6, 0x69, 0x43, 0xec,\\n 0x41, 0x3b, 0xaa, 0x9c, 0x8b, 0xf6 };\\n\\nconst char MBED_CLOUD_DEV_MANUFACTURER[] = \\\"dev_manufacturer\\\";\\n\\nconst char MBED_CLOUD_DEV_MODEL_NUMBER[] = \\\"dev_model_num\\\";\\n\\nconst char MBED_CLOUD_DEV_SERIAL_NUMBER[] = \\\"0\\\";\\n\\nconst char MBED_CLOUD_DEV_DEVICE_TYPE[] = \\\"dev_device_type\\\";\\n\\nconst char MBED_CLOUD_DEV_HARDWARE_VERSION[] = \\\"dev_hardware_version\\\";\\n\\nconst uint32_t MBED_CLOUD_DEV_MEMORY_TOTAL_KB = 0;\\n\\nconst uint32_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_CERTIFICATE_SIZE = sizeof(MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_CERTIFICATE);\\nconst uint32_t MBED_CLOUD_DEV_BOOTSTRAP_SERVER_ROOT_CA_CERTIFICATE_SIZE = sizeof(MBED_CLOUD_DEV_BOOTSTRAP_SERVER_ROOT_CA_CERTIFICATE);\\nconst uint32_t MBED_CLOUD_DEV_LWM2M_SERVER_ROOT_CA_CERTIFICATE_SIZE = sizeof(MBED_CLOUD_DEV_LWM2M_SERVER_ROOT_CA_CERTIFICATE);\\nconst uint32_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_PRIVATE_KEY_SIZE = sizeof(MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_PRIVATE_KEY);\\n\\n#endif //__MBED_CLOUD_DEV_CREDENTIALS_H__\\n"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
201 Developer certificate created successfully. DeveloperCertificateResponseData
400 Bad request. ErrorResponse
401 The provided access token is not valid. ErrorResponse
403 The maximum number of developer certificates for the given account has already been reached. ErrorResponse
409 Certificate with the given name already exists. ErrorResponse

ServerCredentials

get /v3/server-credentials/bootstrap
Fetch bootstrap server credentials. Show more Show less

This REST API is intended to be used by customers to fetch bootstrap server credentials that they will need to use with their clients to connect to bootstrap server.

Example usage: curl -X GET "http://api.us-east-1.mbedcloud.com/v3/server-credentials/bootstrap" -H "accept: application/json" -H "Authorization: Bearer THE_ACCESS_TOKEN"

Request headers
Return type
Example data
Content-Type: Success
{
  "object" : "server-credentials",
  "id" : "015fee4431fd38c98640fbfb00000000",
  "etag" : "1",
  "created_at" : "2017-12-11T14:22:20.009Z",
  "server_certificate" : "-----BEGIN CERTIFICATE-----\\nMIICNTCCAdugAwIBAgIQXCeldn1YhYpDkaBhq8+mWTAKBggqhkjOPQQDAjByMQsw\\nCQYDVQQGEwJHQjEXMBUGA1UECBMOQ2FtYnJpZGdlc2hpcmUxEjAQBgNVBAcTCUNh\\nbWJyaWRnZTEQMA4GA1UEChMHQVJNIEx0ZDEkMCIGA1UEAxMbQVJNIEludGVncmF0\\naW9uIEJvb3RzdHJhcENBMCAXDTE3MDUxNTE5NDkxMVoYDzIwNTIwNTE1MTk1OTEw\\nWjByMQswCQYDVQQGEwJHQjEXMBUGA1UECBMOQ2FtYnJpZGdlc2hpcmUxEjAQBgNV\\nBAcTCUNhbWJyaWRnZTEQMA4GA1UEChMHQVJNIEx0ZDEkMCIGA1UEAxMbQVJNIElu\\ndGVncmF0aW9uIEJvb3RzdHJhcENBMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE\\ni3yGw4hU5l/gV04brCmC6n2RAGOnSgW8VMVxJzMZGy76Qfh6mgxd/LM3AZnFyb54\\nWx3ssBod3ORvVwT0Osqo0qNRME8wCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMB\\nAf8wHQYDVR0OBBYEFBPvafpiPwCG9AW4tuay8dtpELQ5MBAGCSsGAQQBgjcVAQQD\\nAgEAMAoGCCqGSM49BAMCA0gAMEUCIQCiUIgPVegmSeb1cYYzKQVM+f0fFJiShdlc\\nSAKewnmoWQIgPv48oL/TDxWDVrzy+hYmesFoqryRPGlENvl0oYJ2em4=\\n-----END CERTIFICATE-----",
  "server_uri" : "coaps://coap.us-east-1.mbedcloud.com:5684?aid=015843e32ec902420a015e0700000000"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 Bootstrap server credentials fetched successfully. ServerCredentialsResponseData
400 Bad request. ErrorResponse
401 The provided access token is not valid. ErrorResponse
get /v3/server-credentials
Fetch all (Bootstrap and LWM2M) server credentials. Show more Show less

This REST API is intended to be used by customers to fetch all (Bootstrap and LWM2M) server credentials that they will need to use with their clients to connect to bootstrap or LWM2M server.

Example usage: curl -X GET "http://api.us-east-1.mbedcloud.com/v3/server-credentials" -H "accept: application/json" -H "Authorization: Bearer THE_ACCESS_TOKEN"

Request headers
Return type
Example data
Content-Type: Success
{
  "lwm2m" : {
    "certificate" : "-----BEGIN CERTIFICATE-----\\nMIICMDCCAdWgAwIBAgIQJvkI/PHARqRKTSzxlCf5HzAKBggqhkjOPQQDAjBvMQsw\\nCQYDVQQGEwJHQjEXMBUGA1UECBMOQ2FtYnJpZGdlc2hpcmUxEjAQBgNVBAcTCUNh\\nbWJyaWRnZTEQMA4GA1UEChMHQVJNIEx0ZDEhMB8GA1UEAxMYQVJNIEludGVncmF0\\naW9uIExXTTJNIENBMCAXDTE3MDIxMjEwMzc1MloYDzIwNTIwMjEyMTA0NzUyWjBv\\nMQswCQYDVQQGEwJHQjEXMBUGA1UECBMOQ2FtYnJpZGdlc2hpcmUxEjAQBgNVBAcT\\nCUNhbWJyaWRnZTEQMA4GA1UEChMHQVJNIEx0ZDEhMB8GA1UEAxMYQVJNIEludGVn\\ncmF0aW9uIExXTTJNIENBMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEuuqAAS3w\\n4bbFX/l2hDGpKaHHqP2grdmU5+xaM6EsjjZDmxjfznEUJLH7FjQOQ/wjd9QT1xGq\\nOWCrot8ks+ugxaNRME8wCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHQYD\\nVR0OBBYEFHuhpZSl5Y+VXdTO3A+Kvq2aa2Y+MBAGCSsGAQQBgjcVAQQDAgEAMAoG\\nCCqGSM49BAMCA0kAMEYCIQDSBijFMToRjbbLKz/dKpoTMFJ3qtray865XOQyHAL6\\nMAIhALOCJKKxZ2tpBw7Nd3SZBpxZsgDAs7s3W8Ab+9lwmLke\\n-----END CERTIFICATE-----",
    "url" : "coaps://mds.us-east-1.mbedcloud.com:5684?aid=015843e32ec902420a015e0700000000"
  },
  "bootstrap" : {
    "certificate" : "-----BEGIN CERTIFICATE-----\\nMIICNTCCAdugAwIBAgIQXCeldn1YhYpDkaBhq8+mWTAKBggqhkjOPQQDAjByMQsw\\nCQYDVQQGEwJHQjEXMBUGA1UECBMOQ2FtYnJpZGdlc2hpcmUxEjAQBgNVBAcTCUNh\\nbWJyaWRnZTEQMA4GA1UEChMHQVJNIEx0ZDEkMCIGA1UEAxMbQVJNIEludGVncmF0\\naW9uIEJvb3RzdHJhcENBMCAXDTE3MDUxNTE5NDkxMVoYDzIwNTIwNTE1MTk1OTEw\\nWjByMQswCQYDVQQGEwJHQjEXMBUGA1UECBMOQ2FtYnJpZGdlc2hpcmUxEjAQBgNV\\nBAcTCUNhbWJyaWRnZTEQMA4GA1UEChMHQVJNIEx0ZDEkMCIGA1UEAxMbQVJNIElu\\ndGVncmF0aW9uIEJvb3RzdHJhcENBMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE\\ni3yGw4hU5l/gV04brCmC6n2RAGOnSgW8VMVxJzMZGy76Qfh6mgxd/LM3AZnFyb54\\nWx3ssBod3ORvVwT0Osqo0qNRME8wCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMB\\nAf8wHQYDVR0OBBYEFBPvafpiPwCG9AW4tuay8dtpELQ5MBAGCSsGAQQBgjcVAQQD\\nAgEAMAoGCCqGSM49BAMCA0gAMEUCIQCiUIgPVegmSeb1cYYzKQVM+f0fFJiShdlc\\nSAKewnmoWQIgPv48oL/TDxWDVrzy+hYmesFoqryRPGlENvl0oYJ2em4=\\n-----END CERTIFICATE-----",
    "url" : "coaps://coap.us-east-1.mbedcloud.com:5684?aid=015843e32ec902420a015e0700000000"
  }
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 all server credentials fetched successfully. AllServerCredentialsResponseData
400 Bad request. ErrorResponse
401 The provided access token is not valid. ErrorResponse
get /v3/server-credentials/lwm2m
Fetch LWM2M server credentials. Show more Show less

This REST API is intended to be used by customers to fetch LWM2M server credentials that they will need to use with their clients to connect to LWM2M server.

Example usage: curl -X GET "http://api.us-east-1.mbedcloud.com/v3/server-credentials/lwm2m" -H "accept: application/json" -H "Authorization: Bearer THE_ACCESS_TOKEN"

Request headers
Return type
Example data
Content-Type: Success
{
  "object" : "server-credentials",
  "id" : "015fee4431fd38c98640fbfb00000000",
  "etag" : "1",
  "created_at" : "2017-12-11T14:22:20.009Z",
  "server_certificate" : "-----BEGIN CERTIFICATE-----\\nMIICNTCCAdugAwIBAgIQXCeldn1YhYpDkaBhq8+mWTAKBggqhkjOPQQDAjByMQsw\\nCQYDVQQGEwJHQjEXMBUGA1UECBMOQ2FtYnJpZGdlc2hpcmUxEjAQBgNVBAcTCUNh\\nbWJyaWRnZTEQMA4GA1UEChMHQVJNIEx0ZDEkMCIGA1UEAxMbQVJNIEludGVncmF0\\naW9uIEJvb3RzdHJhcENBMCAXDTE3MDUxNTE5NDkxMVoYDzIwNTIwNTE1MTk1OTEw\\nWjByMQswCQYDVQQGEwJHQjEXMBUGA1UECBMOQ2FtYnJpZGdlc2hpcmUxEjAQBgNV\\nBAcTCUNhbWJyaWRnZTEQMA4GA1UEChMHQVJNIEx0ZDEkMCIGA1UEAxMbQVJNIElu\\ndGVncmF0aW9uIEJvb3RzdHJhcENBMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE\\ni3yGw4hU5l/gV04brCmC6n2RAGOnSgW8VMVxJzMZGy76Qfh6mgxd/LM3AZnFyb54\\nWx3ssBod3ORvVwT0Osqo0qNRME8wCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMB\\nAf8wHQYDVR0OBBYEFBPvafpiPwCG9AW4tuay8dtpELQ5MBAGCSsGAQQBgjcVAQQD\\nAgEAMAoGCCqGSM49BAMCA0gAMEUCIQCiUIgPVegmSeb1cYYzKQVM+f0fFJiShdlc\\nSAKewnmoWQIgPv48oL/TDxWDVrzy+hYmesFoqryRPGlENvl0oYJ2em4=\\n-----END CERTIFICATE-----",
  "server_uri" : "coaps://mds.us-east-1.mbedcloud.com:5684?aid=015843e32ec902420a015e0700000000"
}
Produces
This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json
Responses
status description schema
200 LWM2M server credentials fetched successfully. ServerCredentialsResponseData
400 Bad request. ErrorResponse
401 The provided access token is not valid. ErrorResponse

Models

AccountCreationReq

This object represents an account creation request.
display_name (optional)
String The display name for the account, not longer than 100 characters.
company (optional)
String The name of the company, not longer than 100 characters. Required for commercial accounts only.
country (optional)
String The country part of the postal address, not longer than 100 characters. Required for commercial accounts only.
address_line1 (optional)
String Postal address line 1, not longer than 100 characters. Required for commercial accounts only.
address_line2 (optional)
String Postal address line 2, not longer than 100 characters.
city (optional)
String The city part of the postal address, not longer than 100 characters. Required for commercial accounts only.
state (optional)
String The state part of the postal address, not longer than 100 characters.
postal_code (optional)
String The postal code part of the postal address, not longer than 100 characters.
contact (optional)
String The name of the contact person for this account, not longer than 100 characters. Required for commercial accounts only.
email (optional)
String The company email address for this account, not longer than 254 characters. Required for commercial accounts only.
phone_number (optional)
String The phone number of a representative of the company, not longer than 100 characters.
aliases (optional)
array[String] An array of aliases, not more than 10. An alias is not shorter than 8 and not longer than 100 characters.
end_market
String The end market of the account to be created.
admin_name (optional)
String The username of the admin user to be created, containing alphanumerical letters and -,._@+= characters. It must be at least 4 but not more than 30 character long.
admin_password (optional)
String The password when creating a new user. It will be generated when not present in the request.
admin_email (optional)
String The email address of the account admin, not longer than 254 characters.
admin_full_name (optional)
String The full name of the admin user to be created.
contract_number (optional)
String Contract number of the customer.
customer_number (optional)
String Customer number of the customer.

AccountCreationResp

This object represents an account creation response.
id
String Account ID.
admin_id
String The ID of the admin user created.
admin_key (optional)
String The admin API key created for the account.
display_name (optional)
String The display name for the account, not longer than 100 characters.
company (optional)
String The name of the company, not longer than 100 characters. Required for commercial accounts only.
country (optional)
String The country part of the postal address, not longer than 100 characters. Required for commercial accounts only.
address_line1 (optional)
String Postal address line 1, not longer than 100 characters. Required for commercial accounts only.
address_line2 (optional)
String Postal address line 2, not longer than 100 characters.
city (optional)
String The city part of the postal address, not longer than 100 characters. Required for commercial accounts only.
state (optional)
String The state part of the postal address, not longer than 100 characters.
postal_code (optional)
String The postal code part of the postal address, not longer than 100 characters.
contact (optional)
String The name of the contact person for this account, not longer than 100 characters. Required for commercial accounts only.
email (optional)
String The company email address for this account, not longer than 254 characters. Required for commercial accounts only.
phone_number (optional)
String The phone number of a representative of the company, not longer than 100 characters.
aliases (optional)
array[String] An array of aliases, not more than 10. An alias is not shorter than 8 and not longer than 100 characters.
end_market
String The end market of the account to be created.
admin_name (optional)
String The username of the admin user to be created, containing alphanumerical letters and -,._@+= characters. It must be at least 4 but not more than 30 character long.
admin_password (optional)
String The password when creating a new user. It will be generated when not present in the request.
admin_email (optional)
String The email address of the account admin, not longer than 254 characters.
admin_full_name (optional)
String The full name of the admin user to be created.
contract_number (optional)
String Contract number of the customer.
customer_number (optional)
String Customer number of the customer.

AccountInfo

This object represents an account in requests and responses.
object
String Entity name: always 'account'
Enum:
account
id
String Account ID.
etag
String API resource entity version.
created_at (optional)
Date Creation UTC time RFC3339. format: date-time
updated_at (optional)
Date Last update UTC time RFC3339. format: date-time
parent_id (optional)
String The ID of the parent account, if it has any.
display_name (optional)
String The display name for the account.
company (optional)
String The name of the company.
country (optional)
String The country part of the postal address.
address_line1 (optional)
String Postal address line 1.
address_line2 (optional)
String Postal address line 2.
city (optional)
String The city part of the postal address.
state (optional)
String The state part of the postal address.
postal_code (optional)
String The postal code part of the postal address.
contact (optional)
String The name of the contact person for this account.
email (optional)
String The company email address for this account.
phone_number (optional)
String The phone number of a representative of the company.
aliases
array[String] An array of aliases.
tier
String The tier level of the account; '0': free tier, '1': commercial account, '2': partner tier. Other values are reserved for the future.
status
String The status of the account.
Enum:
ENROLLING
ACTIVE
RESTRICTED
SUSPENDED
upgraded_at (optional)
Date Time when upgraded to commercial account in UTC format RFC3339. format: date-time
limits (optional)
map[String, String] List of limits as key-value pairs if requested.
policies (optional)
array[FeaturePolicy] List of policies if requested.
template_id (optional)
String Account template ID.
reason (optional)
String A reason note for updating the status of the account
sub_accounts (optional)
array[AccountInfo] List of sub accounts. Not available for developer users.
end_market
String Account end market.
idle_timeout (optional)
String The reference token expiration time in minutes for this account.
password_policy (optional)
PasswordPolicy The password policy for this account.
reference_note (optional)
String A reference note for updating the status of the account
custom_fields (optional)
map[String, String] Account's custom properties as key-value pairs.
mfa_status (optional)
String The enforcement status of the multi-factor authentication, either 'enforced' or 'optional'.
Enum:
enforced
optional
notification_emails (optional)
array[String] A list of notification email addresses.
sales_contact (optional)
String Email address of the sales contact.
expiration_warning_threshold (optional)
String Indicates how many days (1-180) before account expiration a notification email should be sent.
contract_number (optional)
String Contract number of the customer.
customer_number (optional)
String Customer number of the customer.
parent_account (optional)
ParentAccountInfo Contact details of the parent account.

AccountInfoList

object
String Entity name: always 'list'
Enum:
list
limit
Integer The number of results to return, (range: 2-1000), or equals to total_count format: int32
after (optional)
String The entity ID to fetch after the given one.
order (optional)
String The order of the records to return based on creation time. Available values: ASC, DESC; by default ASC.
Enum:
ASC
DESC
total_count
Integer The total number or records, if requested. It might be returned also for small lists. format: int32
has_more
Boolean Flag indicating whether there is more results.
data
array[AccountInfo] A list of entities.

AccountUpdateReq

This object represents an account creation request.
display_name (optional)
String The display name for the account, not longer than 100 characters.
company (optional)
String The name of the company, not longer than 100 characters. Required for commercial accounts only.
country (optional)
String The country part of the postal address, not longer than 100 characters. Required for commercial accounts only.
address_line1 (optional)
String Postal address line 1, not longer than 100 characters. Required for commercial accounts only.
address_line2 (optional)
String Postal address line 2, not longer than 100 characters.
city (optional)
String The city part of the postal address, not longer than 100 characters. Required for commercial accounts only.
state (optional)
String The state part of the postal address, not longer than 100 characters.
postal_code (optional)
String The postal code part of the postal address, not longer than 100 characters.
contact (optional)
String The name of the contact person for this account, not longer than 100 characters. Required for commercial accounts only.
email (optional)
String The company email address for this account, not longer than 254 characters. Required for commercial accounts only.
phone_number (optional)
String The phone number of a representative of the company, not longer than 100 characters.
aliases (optional)
array[String] An array of aliases, not more than 10. An alias is not shorter than 8 and not longer than 100 characters.
end_market (optional)
String The end market for this account, not longer than 100 characters.
idle_timeout (optional)
String The reference token expiration time in minutes for this account. Between 1 and 120 minutes.
password_policy (optional)
PasswordPolicy Password policy for this account.
custom_fields (optional)
map[String, String] Account's custom properties as key-value pairs, with a maximum of 10 keys. The maximum length of a key is 100 characters. The values are handled as strings and the maximum length for a value is 1000 characters.
mfa_status (optional)
String The enforcement status of setting up the multi-factor authentication. 'Enforced' means that setting up the MFA is required after login. 'Optional' means that the MFA is not required.
Enum:
enforced
optional
notification_emails (optional)
array[String] A list of notification email addresses.
expiration_warning_threshold (optional)
String Indicates how many days before account expiration a notification email should be sent. Valid values are: 1-180.

AccountUpdateRootReq

This object represents an account update request.
display_name (optional)
String The display name for the account, not longer than 100 characters.
company (optional)
String The name of the company, not longer than 100 characters. Required for commercial accounts only.
country (optional)
String The country part of the postal address, not longer than 100 characters. Required for commercial accounts only.
address_line1 (optional)
String Postal address line 1, not longer than 100 characters. Required for commercial accounts only.
address_line2 (optional)
String Postal address line 2, not longer than 100 characters.
city (optional)
String The city part of the postal address, not longer than 100 characters. Required for commercial accounts only.
state (optional)
String The state part of the postal address, not longer than 100 characters.
postal_code (optional)
String The postal code part of the postal address, not longer than 100 characters.
contact (optional)
String The name of the contact person for this account, not longer than 100 characters. Required for commercial accounts only.
email (optional)
String The company email address for this account, not longer than 254 characters. Required for commercial accounts only.
phone_number (optional)
String The phone number of a representative of the company, not longer than 100 characters.
aliases (optional)
array[String] An array of aliases, not more than 10. An alias is not shorter than 8 and not longer than 100 characters.
end_market (optional)
String The end market for this account, not longer than 100 characters.
idle_timeout (optional)
String The reference token expiration time in minutes for this account. Between 1 and 120 minutes.
password_policy (optional)
PasswordPolicy Password policy for this account.
custom_fields (optional)
map[String, String] Account's custom properties as key-value pairs, with a maximum of 10 keys. The maximum length of a key is 100 characters. The values are handled as strings and the maximum length for a value is 1000 characters.
mfa_status (optional)
String The enforcement status of setting up the multi-factor authentication. 'Enforced' means that setting up the MFA is required after login. 'Optional' means that the MFA is not required.
Enum:
enforced
optional
notification_emails (optional)
array[String] A list of notification email addresses.
sales_contact (optional)
String Email address of the sales contact.
expiration_warning_threshold (optional)
String Indicates how many days before account expiration a notification email should be sent. Valid values are: 1-180.
contract_number (optional)
String Contract number of the customer.
customer_number (optional)
String Customer number of the customer.

AllServerCredentialsResponseData

bootstrap (optional)
lwm2m (optional)

ApiKeyInfoReq

This object represents an API key in requests towards Device Management.
name
String The display name for the API key, not longer than 100 characters.
owner (optional)
String The owner of this API key.
groups (optional)
array[String] A list of group IDs this API key belongs to.
status (optional)
String The status of the API key.
Enum:
ACTIVE
INACTIVE

ApiKeyInfoResp

This object represents an API key in Device Management.
object
String Entity name: always 'api-key'
Enum:
api-key
id
String The ID of the API key.
etag
String API resource entity version.
created_at (optional)
Date Creation UTC time RFC3339. format: date-time
updated_at (optional)
Date Last update UTC time RFC3339. format: date-time
key
String The API key.
name
String The display name for the API key.
groups (optional)
array[String] A list of group IDs this API key belongs to.
owner (optional)
String The owner of this API key, who is the creator by default.
status (optional)
String The status of the API key.
Enum:
ACTIVE
INACTIVE
creation_time (optional)
Long The timestamp of the API key creation in the storage, in milliseconds. format: int64
last_login_time (optional)
Long The timestamp of the latest API key usage, in milliseconds. format: int64
account_id (optional)
String The ID of the account.

ApiKeyInfoRespList

object
String Entity name: always 'list'
Enum:
list
limit
Integer The number of results to return, (range: 2-1000), or equals to total_count format: int32
after (optional)
String The entity ID to fetch after the given one.
order (optional)
String The order of the records to return based on creation time. Available values: ASC, DESC; by default ASC.
Enum:
ASC
DESC
total_count
Integer The total number or records, if requested. It might be returned also for small lists. format: int32
has_more
Boolean Flag indicating whether there is more results.
data
array[ApiKeyInfoResp] A list of entities.

ApiKeyUpdateReq

This object represents an API key in requests towards Device Management.
name
String The display name for the API key, not longer than 100 characters.
owner (optional)
String The owner of this API key.
groups (optional)
array[String] A list of group IDs this API key belongs to.
status (optional)
String The status of the API key.
Enum:
ACTIVE
INACTIVE

CredentialsResponseData

certificate (optional)
String PEM format X.509 server certificate that will be used to validate the server certificate that will be received during the TLS/DTLS handshake.
url (optional)
String Server URI to which the client needs to connect to.

DeveloperCertificateRequestData

name
String Name of the developer certificate, must be unique. There is a limit on the length of the name. Please see TrustedCertificateReq
description (optional)
String Description for the developer certificate. There is a limit on the length of the description. Please see TrustedCertificateReq

DeveloperCertificateResponseData

object (optional)
String Entity name, always 'trusted-cert'
id (optional)
String mUUID that uniquely identifies the developer certificate.
etag (optional)
String API resource entity version.
created_at (optional)
Date Creation UTC time RFC3339. format: date-time
account_id (optional)
String account to which the developer certificate belongs
name (optional)
String Name of the developer certificate.
description (optional)
String Description for the developer certificate.
developer_certificate (optional)
String PEM format X.509 developer certificate.
developer_private_key (optional)
String PEM format developer private key associated to the certificate.
security_file_content (optional)
String Content of the security.c file that will be flashed into the device to provide the security credentials

ErrorResponse

This object represents an error message.
object
String Entity name, always 'error'.
Enum:
error
code
Integer Response code. format: int32
type
String Error type.
Enum:
success
created
accepted
permanently_deleted
validation_error
invalid_token
invalid_apikey
reauth_required
access_denied
account_limit_exceeded
not_found
method_not_supported
not_acceptable
duplicate
precondition_failed
unsupported_media_type
rate_limit_exceeded
internal_server_error
system_unavailable
message
String A human readable message with detailed info.
request_id
String Request ID.
fields (optional)
array[Field] Failed input fields during request object validation.

FeaturePolicy

This object represents a feature policy. Either the feature or the resource must be specified.
resource (optional)
String Resource that is protected by this policy.
action (optional)
String Comma separated list of actions, empty string represents all actions.
allow (optional)
Boolean True or false controlling whether an action is allowed or not.
feature (optional)
String Feature name corresponding to this policy.
inherited (optional)
Boolean Flag indicating whether this feature is inherited or overwritten specifically.

Field

name
String Name of the erroneous field.
message
String Message describing the erroneous situation.

GroupCreationInfo

This object is used when creating new groups.
name
String The group name, not longer than 100 characters.
members (optional)
SubjectList The members of the group as arrays of user and API key IDs.

GroupSummary

This object contains basic information about groups.
object
String Entity name: always 'group'
Enum:
group
id
String The ID of the group.
etag
String API resource entity version.
created_at (optional)
Date Creation UTC time RFC3339. format: date-time
updated_at (optional)
Date Last update UTC time RFC3339. format: date-time
account_id
String The ID of the account this group belongs to.
name
String The name of the group.
user_count
Integer The number of users in this group. format: int32
apikey_count
Integer The number of API keys in this group. format: int32

GroupSummaryList

object
String Entity name: always 'list'
Enum:
list
limit
Integer The number of results to return, (range: 2-1000), or equals to total_count format: int32
after (optional)
String The entity ID to fetch after the given one.
order (optional)
String The order of the records to return based on creation time. Available values: ASC, DESC; by default ASC.
Enum:
ASC
DESC
total_count
Integer The total number or records, if requested. It might be returned also for small lists. format: int32
has_more
Boolean Flag indicating whether there is more results.
data
array[GroupSummary] A list of entities.

GroupUpdateInfo

This object is used when updating groups.
name
String The group name, not longer than 100 characters.

LoginHistory

This object represents an entry in login history.
date
Date UTC time RFC3339 for this login attempt. format: date-time
success
Boolean Flag indicating whether login attempt was successful or not.
ip_address
String IP address of the client.
user_agent
String User Agent header from the login request.

LoginProfileResp

This object represents a user login profile in Device Management.
type
String Identity provider type.
Enum:
NATIVE
MBED
SAML2
OIDC
id
String ID of the identity provider.
name
String Name of the identity provider.

NotificationEntry

This object represents an account notification entry.
object
String Entity name: always 'notification-entry'
Enum:
notification-entry
id
String Entity ID.
etag
String API resource entity version.
created_at (optional)
Date Creation UTC time RFC3339. format: date-time
account_id (optional)
String The ID of the account.
message (optional)
String The message contained in this account notification entry.
type (optional)
String The type of this account notification entry.
subject (optional)
String The subject of this account notification entry.
receiver (optional)
String The receiver this account notification entry.
success (optional)
Boolean A flag indiciating whether the sending of this account notification entry was successful, true or false.
error_msg (optional)
String The error message if there was an error while transmitting the account notification.

NotificationEntryList

object
String Entity name: always 'list'
Enum:
list
limit
Integer The number of results to return, (range: 2-1000), or equals to total_count format: int32
after (optional)
String The entity ID to fetch after the given one.
order (optional)
String The order of the records to return based on creation time. Available values: ASC, DESC; by default ASC.
Enum:
ASC
DESC
total_count
Integer The total number or records, if requested. It might be returned also for small lists. format: int32
has_more
Boolean Flag indicating whether there is more results.
data
array[NotificationEntry] A list of entities.

ParentAccountInfo

This object represents parent account contact details in responses.
id (optional)
String The ID of the parent account
admin_name (optional)
String The name of the admin user who is the contact person of the parent account.
admin_email (optional)
String The email address of the admin user who is the contact person of the parent account.

PasswordPolicy

minimum_length
String Minimum length for the password. A number between 8 and 512.

ServerCredentialsResponseData

object (optional)
String Entity name, always 'server-credentials'
id (optional)
String mUUID that uniquely identifies the entity.
etag (optional)
String API resource entity version.
created_at (optional)
Date Creation UTC time RFC3339. format: date-time
server_certificate (optional)
String PEM format X.509 server certificate that will be used to validate the server certificate that will be received during the TLS/DTLS handshake.
server_uri (optional)
String Server URI to which the client needs to connect to.

SubjectList

This object represents arrays of user and API key IDs.
users (optional)
array[String] An array of user IDs.
apikeys (optional)
array[String] An array of API key IDs.

TrustedCertificateInternalResp

This object represents a trusted certificate in responses.
object
String Entity name: always 'trusted-cert'
Enum:
trusted-cert
id
String Entity ID.
etag
String API resource entity version.
created_at (optional)
Date Creation UTC time RFC3339. format: date-time
updated_at (optional)
Date Last update UTC time RFC3339. format: date-time
name
String Certificate name.
description (optional)
String Human readable description of this certificate.
account_id
String The ID of the account.
owner_id (optional)
String The ID of the owner.
certificate
String X509.v3 trusted certificate in PEM format.
service
String Service name where the certificate is to be used.
Enum:
lwm2m
bootstrap
issuer
String Issuer of the certificate.
subject
String Subject of the certificate.
validity
Date Expiration time in UTC formatted as RFC3339. format: date-time
status (optional)
String Status of the certificate.
Enum:
ACTIVE
INACTIVE
device_execution_mode (optional)
Integer Device execution mode where 1 means a developer certificate. format: int32
private_key
String Private key of the certificate in PEM or base64 encoded DER format.
enrollment_mode (optional)
Boolean If true, signature is not required. Default value false.

TrustedCertificateInternalRespList

object
String Entity name: always 'list'
Enum:
list
limit
Integer The number of results to return, (range: 2-1000), or equals to total_count format: int32
after (optional)
String The entity ID to fetch after the given one.
order (optional)
String The order of the records to return based on creation time. Available values: ASC, DESC; by default ASC.
Enum:
ASC
DESC
total_count
Integer The total number or records, if requested. It might be returned also for small lists. format: int32
has_more
Boolean Flag indicating whether there is more results.
data

TrustedCertificateReq

This object represents a trusted certificate in upload requests.
name
String Certificate name, not longer than 100 characters.
description (optional)
String Human readable description of this certificate, not longer than 500 characters.
certificate
String A chain of X509.v3 trusted certificates in PEM format. The chain must contain all certificates from root to leaf. Otherwise, the signature parameter is required.
service
String Service name where the certificate must be used.
Enum:
lwm2m
bootstrap
status (optional)
String Status of the certificate.
Enum:
ACTIVE
INACTIVE
signature (optional)
String DEPRECATED: Base64 encoded signature of the account ID signed by the certificate to be uploaded. The signature must be hashed with SHA256.
enrollment_mode (optional)
Boolean Certificate is used in enrollment mode. Default value is false.

TrustedCertificateResp

This object represents a trusted certificate in responses.
object
String Entity name: always 'trusted-cert'
Enum:
trusted-cert
id
String Entity ID.
etag
String API resource entity version.
created_at (optional)
Date Creation UTC time RFC3339. format: date-time
updated_at (optional)
Date Last update UTC time RFC3339. format: date-time
name
String Certificate name.
description (optional)
String Human readable description of this certificate.
account_id
String The ID of the account.
owner_id (optional)
String The ID of the owner.
certificate
String X509.v3 trusted certificate in PEM format.
service
String Service name where the certificate is to be used.
Enum:
lwm2m
bootstrap
issuer
String Issuer of the certificate.
subject
String Subject of the certificate.
validity
Date Expiration time in UTC formatted as RFC3339. format: date-time
status (optional)
String Status of the certificate.
Enum:
ACTIVE
INACTIVE
device_execution_mode (optional)
Integer Device execution mode where 1 means a developer certificate. format: int32
enrollment_mode (optional)
Boolean If true, signature is not required. Default value false.

TrustedCertificateRespList

object
String Entity name: always 'list'
Enum:
list
limit
Integer The number of results to return, (range: 2-1000), or equals to total_count format: int32
after (optional)
String The entity ID to fetch after the given one.
order (optional)
String The order of the records to return based on creation time. Available values: ASC, DESC; by default ASC.
Enum:
ASC
DESC
total_count
Integer The total number or records, if requested. It might be returned also for small lists. format: int32
has_more
Boolean Flag indicating whether there is more results.
data
array[TrustedCertificateResp] A list of entities.

TrustedCertificateRootReq

This object represents a trusted certificate in upload requests.
name
String Certificate name, not longer than 100 characters.
description (optional)
String Human readable description of this certificate, not longer than 500 characters.
certificate
String A chain of X509.v3 trusted certificates in PEM format. The chain must contain all certificates from root to leaf. Otherwise, the signature parameter is required.
service
String Service name where the certificate must be used.
Enum:
lwm2m
bootstrap
status (optional)
String Status of the certificate.
Enum:
ACTIVE
INACTIVE
signature (optional)
String DEPRECATED: Base64 encoded signature of the account ID signed by the certificate to be uploaded. The signature must be hashed with SHA256.
enrollment_mode (optional)
Boolean Certificate is used in enrollment mode. Default value is false.

TrustedCertificateUpdateReq

This object represents a trusted certificate in update requests.
name (optional)
String Certificate name, not longer than 100 characters.
description (optional)
String Human readable description of this certificate, not longer than 500 characters.
certificate (optional)
String A chain of X509.v3 trusted certificates in PEM format. The chain must contain all certificates from root to leaf. Otherwise, the signature parameter is required.
service (optional)
String Service name where the certificate must be used.
Enum:
lwm2m
bootstrap
status (optional)
String Status of the certificate.
Enum:
ACTIVE
INACTIVE
signature (optional)
String DEPRECATED: Base64 encoded signature of the account ID signed by the certificate to be uploaded. The signature must be hashed with SHA256.
enrollment_mode (optional)
Boolean Certificate is used in enrollment mode. Default value is false.

UpdatedResponse

This object represents a response to an update request.
object
String Entity name: 'user', 'api-key', 'group', 'policy' or 'account'.
Enum:
user
api-key
group
policy
account
code
Integer Response code. format: int32
type
String Response type: success.
Enum:
success
message
String A human readable message with detailed info.
request_id
String Request ID.
id
String Entity ID.

UserInfoReq

This object represents a user in requests towards Device Management.
password (optional)
String The password when creating a new user. It will be generated when not present in the request.
email
String The email address, not longer than 254 characters.
groups (optional)
array[String] A list of IDs of the groups this user belongs to.
address (optional)
String Address, not longer than 100 characters.
is_marketing_accepted (optional)
Boolean A flag indicating that receiving marketing information has been accepted.
phone_number (optional)
String Phone number, not longer than 100 characters.
full_name (optional)
String The full name of the user, not longer than 100 characters.
is_gtc_accepted (optional)
Boolean A flag indicating that the General Terms and Conditions has been accepted.
username (optional)
String A username containing alphanumerical letters and -,._@+= characters. It must be at least 4 but not more than 30 character long.
login_profiles (optional)
array[String] A list of login profiles for the user. Specified as IDs of the identity providers the user should be associated with. The list cannot be empty. A limit of 100 profiles.

UserInfoResp

This object represents a user in Device Management.
object
String Entity name: always 'user'
Enum:
user
id
String The ID of the user.
etag
String API resource entity version.
created_at (optional)
Date Creation UTC time RFC3339. format: date-time
updated_at (optional)
Date Last update UTC time RFC3339. format: date-time
status
String The status of the user. ENROLLING state indicates that the user is in the middle of the enrollment process. INVITED means that the user has not accepted the invitation request. RESET means that the password must be changed immediately. INACTIVE users are locked out and not permitted to use the system.
Enum:
ENROLLING
INVITED
ACTIVE
RESET
INACTIVE
username (optional)
String A username containing alphanumerical letters and -,._@+= characters.
password (optional)
String The password when creating a new user. It will be generated when not present in the request.
full_name (optional)
String The full name of the user.
email
String The email address.
address (optional)
String Address.
phone_number (optional)
String Phone number.
groups (optional)
array[String] A list of IDs of the groups this user belongs to.
is_gtc_accepted (optional)
Boolean A flag indicating that the General Terms and Conditions has been accepted.
is_marketing_accepted (optional)
Boolean A flag indicating that receiving marketing information has been accepted.
email_verified (optional)
Boolean A flag indicating whether the user's email address has been verified or not.
creation_time (optional)
Long A timestamp of the user creation in the storage, in milliseconds. format: int64
last_login_time (optional)
Long A timestamp of the latest login of the user, in milliseconds. format: int64
password_changed_time (optional)
Long A timestamp of the latest change of the user password, in milliseconds. format: int64
account_id
String The ID of the account.
login_history (optional)
array[LoginHistory] Timestamps, succeedings, IP addresses and user agent information of the last five logins of the user, with timestamps in RFC3339 format.
is_totp_enabled (optional)
Boolean A flag indicating whether 2-factor authentication (TOTP) has been enabled.
login_profiles (optional)
array[LoginProfileResp] A list of login profiles for the user. Specified as the identity providers the user is associated with.

UserInfoRespList

object
String Entity name: always 'list'
Enum:
list
limit
Integer The number of results to return, (range: 2-1000), or equals to total_count format: int32
after (optional)
String The entity ID to fetch after the given one.
order (optional)
String The order of the records to return based on creation time. Available values: ASC, DESC; by default ASC.
Enum:
ASC
DESC
total_count
Integer The total number or records, if requested. It might be returned also for small lists. format: int32
has_more
Boolean Flag indicating whether there is more results.
data
array[UserInfoResp] A list of entities.

UserUpdateReq

This object represents a user in requests towards Device Management.
email (optional)
String The email address, not longer than 254 characters.
address (optional)
String Address, not longer than 100 characters.
is_marketing_accepted (optional)
Boolean A flag indicating that receiving marketing information has been accepted.
phone_number (optional)
String Phone number, not longer than 100 characters.
full_name (optional)
String The full name of the user, not longer than 100 characters.
is_gtc_accepted (optional)
Boolean A flag indicating that the General Terms and Conditions has been accepted.
username (optional)
String A username containing alphanumerical letters and -,._@+= characters. It must be at least 4 but not more than 30 character long.
status (optional)
String The status of the user.
is_totp_enabled (optional)
Boolean A flag indicating whether 2-factor authentication (TOTP) has to be enabled or disabled.
groups (optional)
array[String] A list of group IDs this user belongs to.
login_profiles (optional)
array[String] A list of login profiles for the user. Specified as IDs of the identity providers the user should be associated with. The list cannot be empty. A limit of 100 profiles.
Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.