Remove an account's saved site login

Overview

Remove an account's saved (account-level) login for a review site, the copy that new locations inherit.

You'll need the saved login's id, from Get an account's saved site logins (data.data.id). Call it with the account's own token: a Partner token gets 422 even for an account in its tree.

Only the account-level copy is deleted. Logins already saved on each location are left as they are.

Prerequisites

Base URL

EnvironmentURL
Productionhttps://production-api.shoutaboutus.com
Developmenthttps://development-api.shoutaboutus.com

Endpoint

DELETE /api/v1/store-review-site/company/credentials

Authentication

Account token

  • The saved login must belong to the account behind the token. A Partner token gets 422, even for an account in its tree.
  • An id that doesn't exist, or belongs to another account, is rejected with 422.

Rate limit

This endpoint has no rate limit.

Request parameters

ParameterInTypeRequiredDescription
idqueryintegerYesThe saved login's id (data.data.id from Get an account's saved site logins). Must be a saved site login of your own account.

Request body

None.

Request payload

None.

Response body

The payload is inside data.

FieldTypeDescription
statusstringsuccess.
messagestringCompany review site login deleted successfully

Response payload

{
  "data": {
    "status": "success",
    "message": "Company review site login deleted successfully"
  }
}

Examples

Success payload

See Response payload.

Error payload

422 Missing id

{
  "message": "The id field is required.",
  "errors": {
    "id": [
      "The id field is required."
    ]
  }
}

422 Not a saved login of your account

{
  "message": "The selected id is invalid.",
  "errors": {
    "id": [
      "The selected id is invalid."
    ]
  }
}

422 id isn't an integer

{
  "message": "The id field must be an integer.",
  "errors": {
    "id": [
      "The id field must be an integer."
    ]
  }
}
StatusMeaning
200The account-level login was deleted.
401The token is missing, expired or invalid.
422id is missing or not an integer, doesn't exist, or isn't a saved login of your own account (for example, a Partner token).
500Unexpected server error.

Example request

curl --request DELETE \
  --url "https://production-api.shoutaboutus.com/api/v1/store-review-site/company/credentials?id=42" \
  --header 'Authorization: Bearer <bearer-token>' \
  --header 'Accept: application/json'

Did this page help you?