POST Upload Client Logs¶

Upload Client Logs API allows the application to upload the client logs to the server for further analysis. This method allows you to upload client logs for an application. If the client log upload option is enabled for the specified application, then the client logs get uploaded.

HTTP Method: POST.

URL: https://<mobile services host>/mobileservices/application/{application}/clientlogs/v1/runtime/log/application/{applicationId}?deviceId={deviceId}

Request Parameters:

Parameter	Type	Description	Parameter Type
`applicationId`	Required	Application identifier	String
`deviceId`	Optional	Device identifier. This value will be saved with the uploaded log if specified.	String
`clientlogs`	Required	Client logs
Client logs	<any>	Serialized Client logs. These can be zipped data, multipart data or simple binary data. Log format: `~~~ #Date time#Severity#CorrelationId#Source#Location#Message# ~~~` The format of Date time is `YYYY-MM-DDThh:mm:ss.sTZD` For example: `2014-07-01T17:16:08.637+02:00` The valid values of Severity are `DEBUG`, `INFO`, `WARN`, `ERROR` and `FATAL`. The `CorrelationId` value is optional, and can be left as empty if client cannot provide it for each log message. The Message value is log message generated by client, and # character in it must be escaped to avoid corrupt uploading.`

Request Headers:

Header	Type	Description
`X-SOURCE-IDENTIFIER`	Optional	Identifies the part of the application that produced the logs, such as the main app or an app extension. The value is case-insensitive. If the header is omitted or blank, it defaults to `main`. Unrecognized values are rejected with a `400` response. Supported values: `main` `widget-extension` `notification-service-extension` `notification-content-extension` `app-intent-extension` `watchOS-extension` `unknown-app-extension`

Response Status and Error Codes¶

Code	Description
204	Client logs uploaded.
400	Invalid log format, or an unsupported `X-SOURCE-IDENTIFIER` header value.
403	Client log upload is not enabled for the application.
404	No application found.
500	Unexpected error.

Last update: October 14, 2026