Skip to content
Identity and Access Management

Device Application

Create an application in device using Application POST API. While creating the application, the certificate for the application also would be created and returned in the response.

Inputs

Section titled “Inputs”
  • csr and subscriptionScopes are the mandatory fields for creating a application.
  • The name of the application should be given as common_name field of the csr, this name should be unique.
  • Description & displayName are optional fields. When displayName is not given, the application name is computed from csr. *The subscriptionScopes field is a list of applications to which the application will be subscribed. Each scope must reference a valid IAM application.

Authorization

Section titled “Authorization”
  • This API requires device authentication. A device is authorized to create an application within itself.
  • By default, the application will be associated in the account of the device that created it.

Example Request:

POST {base URL}/devices/{deviceId}/applications

Request Body

{
    "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIBIjCB0AIBADANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA7V1+..\n-----END CERTIFICATE REQUEST-----",
    "subscriptionScopes": ["iam-test", "iot-test-app"],
    "description":"test Description",
    "displayName": "test application"
}

####Fields required in CSR

ParameterData TypeDescription
common_name*stringname of the application to be created

Success Response (201):

{
    "metadata": {
        "createdBy": "trn:2:iam:us:device:b2cbfd1f-af0c-42f5-9cdf-1029f9a3ee07",
        "createdAt": "2025-12-04T15:36:52.708000Z",
        "updatedBy": "trn:2:iam:us:device:b2cbfd1f-af0c-42f5-9cdf-1029f9a3ee07",
        "updatedAt": "2025-12-04T15:36:52.708000Z"
    },
    "id": "026a24df-8b88-4617-b68a-e58bc8468ff2",
    "applicationName": "application-3489",
    "description": "test Description",
    "certificate": "-----BEGIN CERTIFICATE----- MIIDXTCCAkWgAkiG9w0BAQsFAwIBAgIJALa6+2y+0zANBgkqhDBoMQswCQYDVQQG... -----END CERTIFICATE-----",
    "displayName": "test application",
    "subscriptionScopes": [
        "iam-test", "iot-test-app"
    ],
    "trn": "trn:2:iam:us:application:026a24df-8b88-4617-b68a-e58bc8468ff2"
}