Organisation APIs

Move Organisation Domain

OVERVIEW

Overview

Move an existing domain from one organisation to another within Publisher.  This API call is used to move a domain to a new organisation object in the system. This in turn will move all users who have an email address associated with that domain to the new organisation.

Since v4.6

Enhanced v5.0

HTTP Request

POST  /api/2/organisations/<ORGID>/domains/<DOMAIN>?neworganisation=<NEWORGID>

URL Parameters
Parameter Description
ORGID The ID of the organisation to move the domain from
DOMAIN The domain name to be moved
NEWORGID The ID of the organisation to move the domain to

 

HTTP Request Object

None

 

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 Response

Success

HTTP response 200

(Example below)

 

Error

See API Error messages

 

Example HTTP Request & Response

POST http://example.com/context/api/2/organisations/3/domains/domain.com?neworganisation=4

 

 

JSON Response

{

    "domain": {
        "id": 170,
        "url": "domain.com",
        "status": "Active"
    }

}

 

 

Comments


0 Comments

Last Updated: Nov 08,2024