Accounts / Statuses

Update Account Status

This endpoint allows you to update a specific Account Status. If the specified Account Status does not exist, the response will be a "bad request".

You will only be able to update a Account Status after first providing the Session Key. To know how you can obtain the Session Key, go to Authentication.

HEADERS

ParameterValueDescription
Content-Typeapplication/jsonLanguage in which all request and response bodies are encoded
Accept*/*Any data of whatever mime type is accepted
X-Session-KeyAUTH_TOKENThis field must be completed with the token obtained at the authentication

REQUEST

This endpoint allows updating the information of a specific Account Status. In order to update an Account Status, you just have to specify the attributes you want to modify and complete with the up to date information. It is not necessary to send all attributes.

AttributeTypeDescription
branchVisibilityArrayIn which Branch the Account Status is visible
wonBooleanIf true, the Account Status has been won
lostBooleanIf true, the Account Status has been lost
descriptionDEStringAccount Status label in German
descriptionDKStringAccount Status label in Dutch
descriptionENStringAccount Status label in English
descriptionESStringAccount Status label in Spanish
descriptionFRStringAccount Status label in French
descriptionITStringAccount Status label in Italian
descriptionPTStringAccount Status label in Portuguese
descriptionRUStringAccount Status label in Russian
descriptionUSStringAccount Status label in American English
orderIntegerThe position of the Account Status in the Account Statuses value list

RESPONSE

Returns a JSON with information about the Account Status just updated.

AttributeDescription
MessageShows the operation status

RESPONSE CODES

StatusDescription
200 OKShows if operation succeeded
400 Bad RequestShows when an invalid request or the requested service is not available
put/accountStatuses/{ID}

Request

  • Base URL: https://api.forcemanager.com/api/v4
  • URL: https://api.forcemanager.com/api/v4/accountStatuses/{ID}
  • Auth: API key in header X-Session-Key

Headers

Acceptstring

Request body

descriptionENstring
lostboolean
wonboolean
orderinteger

Response

Update Account Status

Changes

No recorded changes to this operation across all 1 revision of this API.