Update Organisation

Organisation APIs

Update Organisation

OVERVIEW

Overview

Update an existing organisation in Publisher

This API call is used to update an existing organisation in the system, by replacing the organisation with the provided organisation object.

Since v4.6

HTTP Request

PUT /api/2/organisations/<ID>

HTTP Request Object

Organisation Object, either in JSON or XML format.

URL Parameters

Parameter	Description
ID	The ID of the organisation to update

HTTP Headers

HTTP Request Header	Description	Example
Authorization	The API Authorisation token	"Bearer XXXXXXXXXXXXX"
Accept	The format of the expected response. "application/json" "application/xml" If no parameter is set, JSON is the default response given.	"application/xml"
Content-Type	The format of the provided content. "application/json" "application/xml" If no parameter is set, JSON is the expected content by default.	"application/json"

HTTP Request Header

Description

Example

Authorization

The API Authorisation token

"Bearer XXXXXXXXXXXXX"

Accept

The format of the expected response.

"application/json"
"application/xml"

If no parameter is set, JSON is the default response given.

"application/xml"

Content-Type

The format of the provided content.

"application/json"
"application/xml"

If no parameter is set, JSON is the expected content by default.

"application/json"

HTTP Response

Success

HTTP response 200 with Organisation summary Object

(Example below)

Error

See API Error messages

Example HTTP Request & Response

PUT http://example.com/context/api/2/organisations/3

JSON Request

{

"organisation": {

"id": 3,

"name": "HighQ",

"status": "Active",

"autologin": true,

"domains": [

"highq.com"

"homepage": 451,

"guid": 23,

"url": "http://highq.com",

"addresses": [

{

"addressid": 8,

"isDefault": true

}

"img": "http://example.com/img.jpg",

"industry": 359,

"category": 145,

"keycontacts": [

476,

512,

987

"users": [

143,