REST API‎ > ‎TalkSpaces‎ > ‎

Move

This method moves user from one TalkSpace to another. 

Method: POST 
URI: /api/rest/conference/{conferenceid}/{networkid}

Path parameters: 
  • conferenceid  The conference ID of a conference that networkid is currently participating in.
  • networkid  The network ID to be moved between conferences.
Form parameters: 
  • appkey  The application key
  • toconferenceid  The conference ID to which the networkid should be moved.  
  • action  The action to be performed - ("move").
Returns: 
  • OK(200) - The call leg has been moved. 
  • BAD_REQUEST(400) - Missing or invalid parameter(s). 
  • UNAUTHORIZED(401) - The specified network ID is not associated with the application identified by the application key. 
  • BAD_GATEWAY(502) - Unable to move call. 
Response format: JSON 

Example using curl 

curl -d "appkey=1f1bbca5-b71f-4938-97b6-59fed80623bc&action=move&toconferenceid=6e90c34d6aaf4921a5fd0a3f6bffa9c1" https://api.telesocial.com/api/rest/conference/09c8c2994baa46949756b3d01ece44a5/eta 

Response body: 
{"ConferenceResponse":{"message":"moved","status":200,"conferenceId":"","uri":"/api/rest/conference/6e90c34d6aaf4921a5fd0a3f6bffa9c1/eta"}} 

JAVA Example

  public void move(HasConferenceId toConference, HasNetworkId networkInfo) {
        UrlBuilder urlBuilder = urlBuilderFactory.get()
                .addPathSegment("conference")
                .addPathSegment(conference.getConferenceId())
                .addPathSegment(networkInfo.getNetworkId())
                .addPostParameter("toconferenceid",toConference.getConferenceId())
                .addPostParameter("action","move");
        URL url = urlBuilder.create();
        ConnectionUtil.doPost(url, conference.getConferenceId(),
                urlBuilder.getPostContents());

    }