===========
Workspaces
===========

A Workspace is a container for your Tasks, Workers, TaskQueues, Workflows and Activities. Each of these items exists within a single Workspace and will not be shared across Workspaces. 

Creating a Workspace
==============================

.. code-block:: php

	require 'Services/Twilio.php';

	// set account parameters 
	$accountSid = 'YOUR_ACCOUNT_SID';
	$authToken = 'YOUR_AUTH_TOKEN';

	// instantiate a Twilio TaskRouter Client 
	$taskrouterClient = new TaskRouter_Services_Twilio($accountSid, $authToken, null);
	
	// create a workspace
	$workspace = $taskrouterClient->createWorkspace(
		$accountSid,		// AccountSid
		$authToken, 		// AuthToken
		$friendlyName 		// name for workspace
	);

	// confirm workspace created
	echo 'Created Workspace: '.$workspace->sid; 

Updating a Workspace
==============================

This update below alters the workspace to a new FriendlyName and EventCallbackUrl.

.. code-block:: php

		$workspaceSid = 'YOUR_WORKSPACE_SID';

		$taskrouterClient = new TaskRouter_Services_Twilio($accountSid, $authToken, $workspaceSid);

		// updated workspace parameters
		$updatedFriendlyName = 'My Updated Workspace';
		$updatedEventCallbackUrl = 'http://updatedEventCallbackUrl.org'; 

		// update workspace
		$taskrouterClient->workspace->update(
			array(
				'FriendlyName' => $updatedFriendlyName,
				'EventCallbackUrl' => $updatedEventCallbackUrl
			)
		);

		echo 'Updated Workspace: '.$workspaceSid; 


Deleting a Workspace
==============================

.. code-block:: php

	$workspaceSid = 'YOUR_WORKSPACE_SID';

	$taskrouterClient->workspaces->delete($workspaceSid); 

	echo 'Deleted Workspace: '.$workspaceSid; 


Get a List of all Workspaces
==============================

.. code-block:: php

	foreach($taskrouterClient->workspaces as $workspace)
	{
		echo $workspace->sid; 
	}