Administrative Services

The PowerAuth Admin API consists of several API resource groups:

Possible Error Codes

The API may return one of the following error codes:

HTTP Status Code Error Code Description
400 ERROR_REGISTRATION Registration related error occurred.
400 ERROR_REGISTRATION_NOT_FOUND Registration was not found during a call where registration is expected.
400 ERROR_REGISTRATION_NOT_ALLOWED Registration was not allowed because another registration is already in progress for the user.
400 ERROR_REGISTRATION_CHANGE Invalid registration change was attempted.
400 ERROR_OPERATION_NOT_FOUND Operation was not found during a call where operation is expected.
400 ERROR_OPERATION_STATE_CHANGE Invalid operation change was attempted.
400 ERROR_OTP_INVALID Offline certification - OTP format is invalid.
400 ERROR_AUDIT Error occurred while fetching the audit log.
400 ERROR_REQUEST Request did not pass validation (mandatory property missing, null/invalid value).
401 ERROR_UNAUTHORIZED Returned in the case authentication fails (invalid application credentials).
404 ERROR_NOT_FOUND Returned in the case URL is not present (calling wrong API).
500 ERROR_GENERIC Unknown error occurred while processing request.
500 ERROR_INTERNAL_API Communication with internal service failed.

Please ensure your application handles these errors appropriately, displaying user-friendly messages or taking corrective actions as needed.

Application Services

post /admin/applications Create Application

Create a new app with provided ID.

Request

{
  "id": "MY_APP_01",
  "roles": [
    "ROLE1",
    "ROLE2"
  ]
}

Response

{
  "id": "MY_APP_01",
  "serviceBaseUrl": "https://api.example.com/",
  "mobileSdkConfig": "ARB...w==",
  "roles": [
    "ROLE1", "ROLE2"
  ],
  "appKey": "b34...==",
  "appSecret": "aef...==",
  "masterServerPublicKey": "MIIB...=="
}
Attribute Type Description
id* String Name of the application.
serviceBaseUrl* URL Base URL of the PowerAuth Standard RESTful API.
mobileSdkConfig* String Configuration string for mobile SDK.
roles* String[] Collection of application roles.
appKey* String (deprecated) App Key (value for the mobile app configuration).
appSecret* String (deprecated) App Secret (value for the mobile app configuration).
masterServerPublicKey* String (deprecated) Master Server Public Key (value for the mobile app configuration).

Unable to return application because of the invalid application name or version.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "No enabled application version was found"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

get /admin/applications Get Application List

Obtain a list of all the applications in the system.

Request

Empty Request

Response

{
  "applications": [
    {
      "id": "demo-app1"
    },
    {
      "id": "demo-app2"
    }
  ]
}
Attribute Type Description
applications* String Root element for the application list.
applications[].id String Unique identifier of the application

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

get /admin/applications/{id} Get App Details

Obtain the configuration for an app with provided ID.

Request

Path Params
Param Type Description
id String ID of the application.

Response

{
  "id": "MY_APP_01",
  "serviceBaseUrl": "https://api.example.com/",
  "mobileSdkConfig": "ARB...w==",
  "roles": [
    "ROLE1", "ROLE2"
  ],
  "appKey": "b34...==",
  "appSecret": "aef...==",
  "masterServerPublicKey": "MIIB...=="
}
Attribute Type Description
id* String Name of the application.
serviceBaseUrl* URL Base URL of the PowerAuth Standard RESTful API.
mobileSdkConfig* String Configuration string for mobile SDK.
roles* String[] Collection of application roles.
appKey* String (deprecated) App Key (value for the mobile app configuration).
appSecret* String (deprecated) App Secret (value for the mobile app configuration).
masterServerPublicKey* String (deprecated) Master Server Public Key (value for the mobile app configuration).

Unable to return application because of the invalid application name or version.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "No enabled application version was found"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

post /admin/applications/roles Add Roles To Application

Add roles to an app with provided ID. The call ignores duplicities on application roles.

Request

{
  "id": "MY_APP_01",
  "roles": [
    "ROLE1",
    "ROLE2"
  ]
}

Response

{
  "status": "OK"
}

When formal request validation fails, i.e., due to missing application ID.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Invalid method parameter value",
    "violations": [
      {
        "fieldName": "id",
        "hint": "must not be empty"
      }
    ]
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

post /admin/applications/{id}/roles/remove Remove Roles From Application

Remove roles from an app with provided ID. The call ignores missing roles to be removed from an application.

Request

{
  "roles": [
    "ROLE1",
    "ROLE2"
  ]
}
Path Params
Attribute Type Description
id* String ID of the application, whose role should be removed.
Request Params
Attribute Type Description
roles* String[] Collection of roles to be removed.

Response

{
  "status": "OK"
}

When formal request validation fails, i.e., due to missing application ID.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Invalid method parameter value",
    "violations": [
      {
        "fieldName": "id",
        "hint": "must not be empty"
      }
    ]
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

Callback URL Services

PowerAuth Cloud can notify your systems via a callback (sometimes called “webhooks”) whenever status of a registration or an operation changes. This API provides a convenient way to manage callbacks associated with an existing application.

There are two callback types:

  • Registration callbacks are called whenever registration status changes.
  • Operation callbacks are called whenever operation status changes.

post /v2/admin/applications/{appId}/callbacks Create New Callback

Register a new callback url to an existing application.

Request

{
  "name": "$CALLBACK_NAME",
  "type": "$(REGISTRATION_STATUS_CHANGE|OPERATION_STATUS_CHANGE)",
  "callbackUrl": "$CALLBACK_URL",
  "attributes": [
    "$ATTRIBUTE1",
    "$ATTRIBUTE2"
  ],
  "authentication": {
    "httpBasic": {
      "enabled": true,
      "username": "$USERNAME",
      "password": "$PASSWORD"
    }
  }
}
Path Params
Attribute Type Description
appId* String ID of the application to which the callback is registered.
Request Params
Attribute Type Description
name* String Name of the callback to identify the callback purpose.
type* String Type of the callback. Either REGISTRATION_STATUS_CHANGE or OPERATION_STATUS_CHANGE.
callbackUrl* String Callback URL that is able to receive update callbacks.
attributes String[] Attributes to include into the callback.
authentication.httpBasic.enabled Boolean Whether to enable the HTTP basic authentication.
authentication.httpBasic.username String Username for the HTTP basic authentication.
authentication.httpBasic.password String Password for the HTTP basic authentication.

The attributes list differs slightly based on the type of the callback. See the Callback API (WebHooks) for a description of the attributes.

An operation callback can contain the following values:

  • userId
  • applications
  • operationType
  • parameters
  • additionalData
  • activationFlag
  • status
  • data
  • failureCount
  • maxFailureCount
  • signatureType
  • externalId
  • timestampCreated
  • timestampExpires
  • timestampFinalized

A registration callback can contain the following values:

  • userId
  • activationName
  • deviceInfo
  • platform
  • protocol
  • activationFlags
  • activationStatus
  • blockedReason
  • applicationId

Callbacks with mTLS authentication currently cannot be managed via API.

Response

{
  "applicationId": "$APPLICATION_ID",
  "callbackId": "$CALLBACK_ID",
  "name": "$CALLBACK_NAME",
  "callbackUrl": "$CALLBACK_URL",
  "attributes": [
    "$ATTRIBUTE1",
    "$ATTRIBUTE2"
  ],
  "authentication": {
    "httpBasic": {
      "enabled": true,
      "username": "$USERNAME",
      "passwordSet": true
    }
  }
}

Request validation failed.

  • Application with specified applicationId does not exist.
  • Passed callbackUrl is not valid.
{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "$ERROR_MESSAGE"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

get /v2/admin/applications/{appId}/callbacks Get Callback List

List all callbacks associated with a given application.

Request

Path Params
Attribute Type Description
appId* String ID of the application whose callbacks are to be listed.

Response

{
  "callbacks": [
    {
      "applicationId": "$APPLICATION_ID",
      "callbackId": "$CALLBACK_ID",
      "name": "$CALLBACK_NAME",
      "type": "$(REGISTRATION_STATUS_CHANGE|OPERATION_STATUS_CHANGE)",
      "callbackUrl": "$CALLBACK_URL",
      "attributes": [
        "$ATTRIBUTE1",
        "$ATTRIBUTE2"
      ],
      "authentication": {
        "httpBasic": {
          "enabled": true,
          "username": "$USERNAME",
          "passwordSet": true
        }
      }
    }
  ]
}

Request validation failed.

  • Application with specified applicationId does not exist.
{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "$ERROR_MESSAGE"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

put /v2/admin/applications/{appId}/callbacks/{callbackId} Update Callback

Edit an existing callback url.

Request

{
  "name": "$CALLBACK_NAME",
  "callbackUrl": "$CALLBACK_URL",
  "attributes": [
    "$ATTRIBUTE1",
    "$ATTRIBUTE2"
  ],
  "authentication": {
    "httpBasic": {
      "enabled": true,
      "username": "$USERNAME",
      "password": "$PASSWORD"
    }
  }
}
Path Params
Attribute Type Description
appId* String ID of the application whose callback is to be edited.
callbackId* String ID of the callback to edit.
Request Params
Attribute Type Description
name* String Name of the callback to identify the callback purpose.
callbackUrl* String Callback URL that is able to receive update callbacks.
attributes String[] Attributes to include into the callback.
authentication.httpBasic.enabled Boolean Whether to enable the HTTP basic authentication.
authentication.httpBasic.username String Username for the HTTP basic authentication.
authentication.httpBasic.password String Password for the HTTP basic authentication.

The attributes list can contain following values:

  • activationId
  • userId
  • activationName
  • deviceInfo
  • platform
  • activationFlags
  • activationStatus
  • blockedReason
  • applicationId

Response

{
  "applicationId": "$APPLICATION_ID",
  "callbackId": "$CALLBACK_ID",
  "name": "$CALLBACK_NAME",
  "type": "$(REGISTRATION_STATUS_CHANGE|OPERATION_STATUS_CHANGE)",
  "callbackUrl": "$CALLBACK_URL",
  "attributes": [
    "$ATTRIBUTE1",
    "$ATTRIBUTE2"
  ],
  "authentication": {
    "httpBasic": {
      "enabled": true,
      "username": "$USERNAME",
      "passwordSet": true
    }
  }
}

Request validation failed.

  • Application with specified appId does not exist.
  • Callback with specified callbackId does not exist.
  • Passed callbackUrl is not valid.
{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "$ERROR_MESSAGE"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

delete /v2/admin/applications/{appId}/callbacks/{callbackId} Remove Callback

Remove a callback url from an application’s callback list.

Request

Path Params
Attribute Type Description
appId* String ID of the application whose callback is to be removed.
callbackId* String ID of the callback to remove.

Response

{
  "status": "OK"
}
Attribute Type Description
status* String Fixed value OK.

Request validation failed.

  • Application with specified appId does not exist.
  • Callback with specified callbackId does not exist.
{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "$ERROR_MESSAGE"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

Internal Services

Internal callbacks are not supposed to be directly called by the app developer. They are intended for internal systems, as a means to notify the cloud component about various internal changes.

post /internal/callback/operation Operation Callback

Operation status changed internally, i.e., operation expired.

Request

{
  "operationId": "$OPERATION_ID"
}
Attribute Type Description
operationId* UUID ID of an operation check the status on callback in order to obtain the current status.

Response

{
  "status": "OK"
}
Attribute Type Description
status* String Fixed value OK.

Request validation failed.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Required String parameter 'operationId' is not present"
  }
}
  • ERROR_REQUEST - Request did not pass a structural validation (mandatory field is null, invalid field type, etc.).

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

Push Notification Services

get admin/applications/{id}/push Fetch Push Configuration

Fetch push notification configuration for specified application.

Request

Path Params
Param Type Description
id* String ID of the application.

Response

{
  "id": "config123",
  "apns": {
    "topic": "com.example.MyApp",
    "keyId": "ABCD1234",
    "teamId": "EFGH5678",
    "environment": "DEVELOPMENT"
  },
  "fcm": {
    "projectId": "my-fcm-project-123"
  },
  "hms": {
    "projectId": "my-hms-project-456"
  }
}

Attribute Type Description
id* String The unique identifier of the push configuration.
apns Object Contains the Apple Push Notification service (APNs) configuration.
apns.topic* String The application bundle ID for APNs.
apns.keyId* String The identifier of the key used for APNs authentication.
apns.teamId* String The identifier of the team or developer account in the Apple Developer Program.
apns.environment* String Indicates the APNs environment, can be either DEVELOPMENT or PRODUCTION.
fcm Object Contains the Firebase Cloud Messaging (FCM) configuration.
fcm.projectId* String The identifier of the Firebase project for FCM.
hms Object Contains the Huawei Mobile Services (HMS) configuration.
hms.projectId* String The identifier of the HMS project.

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

post admin/applications/{id}/push/apns Update Apple Push Notification Service Configuration

Update Apple push notification service configuration for specified application.

Request

{
  "topic": "com.wultra.apns.topic",
  "keyId": "ABC123DEFG",
  "teamId": "DEF123GHIJ",
  "environment": "PRODUCTION",
  "privateKeyBase64": "QmFzZT...ZmlsZSAoKi5wOCk="
}
Attribute Type Description
topic* String The topic of the APNs request.
keyId* String The key ID for the APNs request.
teamId* String The team ID for the APNs request.
environment* ApnsEnvironment The environment for the APNs request, indicating either development or production.
privateKeyBase64* String Base64 encoded content of the private key file.
Path Params
Param Type Description
id * String ID of the application.

Response

{
  "id": "config123",
  "apns": {
    "topic": "com.example.MyApp",
    "keyId": "ABCD1234",
    "teamId": "EFGH5678",
    "environment": "DEVELOPMENT"
  },
  "fcm": {
    "projectId": "my-fcm-project-123"
  },
  "hms": {
    "projectId": "my-hms-project-456"
  }
}

Attribute Type Description
id* String The unique identifier of the push configuration.
apns Object Contains the Apple Push Notification service (APNs) configuration.
apns.topic* String The application bundle ID for APNs.
apns.keyId* String The identifier of the key used for APNs authentication.
apns.teamId* String The identifier of the team or developer account in the Apple Developer Program.
apns.environment* String Indicates the APNs environment, can be either DEVELOPMENT or PRODUCTION.
fcm Object Contains the Firebase Cloud Messaging (FCM) configuration.
fcm.projectId* String The identifier of the Firebase project for FCM.
hms Object Contains the Huawei Mobile Services (HMS) configuration.
hms.projectId* String The identifier of the HMS project.

Request validation failed.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Required String parameter 'topic' is not present"
  }
}
  • ERROR_REQUEST - Request did not pass a structural validation (mandatory field is null, invalid field type, etc.).

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

delete admin/applications/{id}/push/apns Delete Apple Push Notification Service Configuration

Delete Apple push notification configuration for specified application.

Request

Path Params
Param Type Description
id * String ID of the application.

Response

{
  "status": "OK"
}
Attribute Type Description
status* String Fixed value OK.

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

post admin/applications/{id}/push/fcm Update Firebase Cloud Messaging Configuration

Update Firebase cloud messaging configuration for specified application.

Request

{
  "projectId": "fcm-project-id",
  "privateKeyBase64": "QmFzZT...ZmlsZSAoKi5wOCk="
}
Attribute Type Description
projectId String The project id of the FCM request.
privateKeyBase64* String Base64 encoded content of the private key file.
Path Params
Param Type Description
id * String ID of the application.

Response

{
  "id": "config123",
  "apns": {
    "topic": "com.example.MyApp",
    "keyId": "ABCD1234",
    "teamId": "EFGH5678",
    "environment": "DEVELOPMENT"
  },
  "fcm": {
    "projectId": "my-fcm-project-123"
  },
  "hms": {
    "projectId": "my-hms-project-456"
  }
}

Attribute Type Description
id* String The unique identifier of the push configuration.
apns Object Contains the Apple Push Notification service (APNs) configuration.
apns.topic* String The application bundle ID for APNs.
apns.keyId* String The identifier of the key used for APNs authentication.
apns.teamId* String The identifier of the team or developer account in the Apple Developer Program.
apns.environment* String Indicates the APNs environment, can be either DEVELOPMENT or PRODUCTION.
fcm Object Contains the Firebase Cloud Messaging (FCM) configuration.
fcm.projectId* String The identifier of the Firebase project for FCM.
hms Object Contains the Huawei Mobile Services (HMS) configuration.
hms.projectId* String The identifier of the HMS project.

Request validation failed.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Required String parameter 'privateKeyBase64' is not present"
  }
}
  • ERROR_REQUEST - Request did not pass a structural validation (mandatory field is null, invalid field type, etc.).

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

delete admin/applications/{id}/push/fcm Delete Firebase Cloud Messaging Configuration

Delete Firebase cloud messaging configuration for specified application.

Request

Path Params
Param Type Description
id * String ID of the application.

Response

{
  "status": "OK"
}
Attribute Type Description
status* String Fixed value OK.

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

post admin/applications/{id}/push/hms Update Huawei Mobile Services Configuration

Update Huawei mobile services configuration for specified application.

Request

{
  "projectId": "hms-project-id",
  "appId": "my-app-id",
  "clientId": "my-client-id",
  "clientSecret": "my-client-secret"
}
Attribute Type Description
projectId* String The project ID for the HMS request. Example: “hms-project-id”.
appId* String Application ID for the HMS request.
clientId* String Huawei OAuth 2.0 client ID.
clientSecret* String Huawei OAuth 2.0 client secret.
Path Params
Param Type Description
id * String ID of the application.

Response

{
  "id": "config123",
  "apns": {
    "topic": "com.example.MyApp",
    "keyId": "ABCD1234",
    "teamId": "EFGH5678",
    "environment": "DEVELOPMENT"
  },
  "fcm": {
    "projectId": "my-fcm-project-123"
  },
  "hms": {
    "projectId": "my-hms-project-456"
  }
}

Attribute Type Description
id* String The unique identifier of the push configuration.
apns Object Contains the Apple Push Notification service (APNs) configuration.
apns.topic* String The application bundle ID for APNs.
apns.keyId* String The identifier of the key used for APNs authentication.
apns.teamId* String The identifier of the team or developer account in the Apple Developer Program.
apns.environment* String Indicates the APNs environment, can be either DEVELOPMENT or PRODUCTION.
fcm Object Contains the Firebase Cloud Messaging (FCM) configuration.
fcm.projectId* String The identifier of the Firebase project for FCM.
hms Object Contains the Huawei Mobile Services (HMS) configuration.
hms.projectId* String The identifier of the HMS project.

Request validation failed.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Required String parameter 'projectId' is not present"
  }
}
  • ERROR_REQUEST - Request did not pass a structural validation (mandatory field is null, invalid field type, etc.).

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

delete admin/applications/{id}/push/hms Delete Huawei Mobile Service Configuration

Delete Huawei mobile service configuration for specified application.

Request

Path Params
Param Type Description
id * String ID of the application.

Response

{
  "status": "OK"
}
Attribute Type Description
status* String Fixed value OK.

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}
Last updated on Sep 17, 2024 (15:06) View product
Search

1.8.x

PowerAuth Cloud