Application Certificate Actions
https://api.losant.com/applications/APPLICATION_ID
/certificates/APPLICATION_CERTIFICATE_ID
Below are the various requests that can be performed against the Application Certificate resource, as well as the expected parameters and the potential responses.
Delete
Deletes an application certificate
Method And Url
DELETE https://api.losant.com/applications/APPLICATION_ID
/certificates/APPLICATION_CERTIFICATE_ID
Authentication
A valid api access token is required to access this endpoint. The token must include at least one of the following scopes: all.Application, all.Organization, all.User, applicationCertificate.*, or applicationCertificate.delete.
Request Path Components
Path Component | Description | Example |
---|---|---|
APPLICATION_ID | ID associated with the application | 575ec8687ae143cd83dc4a97 |
APPLICATIONCERTIFICATEID | ID associated with the application certificate | 575ec76c7ae143cd83dc4a96 |
Request Headers
Name | Required | Description | Default |
---|---|---|---|
Authorization | Y | The token for authenticating the request, prepended with Bearer |
Curl Example
curl -H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_API_ACCESS_TOKEN' \
-X DELETE \
https://api.losant.com/applications/APPLICATION_ID/certificates/APPLICATION_CERTIFICATE_ID
Successful Responses
Code | Type | Description |
---|---|---|
200 | Success | If application certificate was successfully deleted |
Error Responses
Code | Type | Description |
---|---|---|
400 | Error | Error if malformed request |
404 | Error | Error if application certificate was not found |
Get
Retrieves information on an application certificate
Method And Url
GET https://api.losant.com/applications/APPLICATION_ID
/certificates/APPLICATION_CERTIFICATE_ID
Authentication
A valid api access token is required to access this endpoint. The token must include at least one of the following scopes: all.Application, all.Application.read, all.Organization, all.Organization.read, all.User, all.User.read, applicationCertificate.*, or applicationCertificate.get.
Request Path Components
Path Component | Description | Example |
---|---|---|
APPLICATION_ID | ID associated with the application | 575ec8687ae143cd83dc4a97 |
APPLICATIONCERTIFICATEID | ID associated with the application certificate | 575ec76c7ae143cd83dc4a96 |
Request Headers
Name | Required | Description | Default |
---|---|---|---|
Authorization | Y | The token for authenticating the request, prepended with Bearer |
Curl Example
curl -H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_API_ACCESS_TOKEN' \
-X GET \
https://api.losant.com/applications/APPLICATION_ID/certificates/APPLICATION_CERTIFICATE_ID
Successful Responses
Code | Type | Description |
---|---|---|
200 | Application Certificate | Application certificate information |
Error Responses
Code | Type | Description |
---|---|---|
400 | Error | Error if malformed request |
404 | Error | Error if application certificate was not found |
Patch
Updates information about an application certificate
Method And Url
PATCH https://api.losant.com/applications/APPLICATION_ID
/certificates/APPLICATION_CERTIFICATE_ID
Authentication
A valid api access token is required to access this endpoint. The token must include at least one of the following scopes: all.Application, all.Organization, all.User, applicationCertificate.*, or applicationCertificate.patch.
Request Path Components
Path Component | Description | Example |
---|---|---|
APPLICATION_ID | ID associated with the application | 575ec8687ae143cd83dc4a97 |
APPLICATIONCERTIFICATEID | ID associated with the application certificate | 575ec76c7ae143cd83dc4a96 |
Request Headers
Name | Required | Description | Default |
---|---|---|---|
Authorization | Y | The token for authenticating the request, prepended with Bearer |
Request Body
The body of the request should be serialized JSON that validates against the Application Certificate Patch schema. For example, the following would be a valid body for this request:
{
"status": "active",
"description": "An example updated certificate description"
}
Curl Example
curl -H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_API_ACCESS_TOKEN' \
-X PATCH \
-d '{"status":"active","description":"An example updated certificate description"}' \
https://api.losant.com/applications/APPLICATION_ID/certificates/APPLICATION_CERTIFICATE_ID
Successful Responses
Code | Type | Description |
---|---|---|
200 | Application Certificate | Updated application certificate information |
Error Responses
Code | Type | Description |
---|---|---|
400 | Error | Error if malformed request |
404 | Error | Error if application certificate was not found |
Was this page helpful?
Still looking for help? You can also search the Losant Forums or submit your question there.