Organizations

An end-user can be a member of an organization.

Show

GET /organizations/#{id}.xml
Returns a single organization.

Response

Status: 200

<organization>
  <id>2</id>
  <name>Support</name>
  <is-shared>true</name>
  <default>ajax-corp.com</default>
</organization>

List All

GET /organizations.xml

Response

Status: 200

<organizations>
  <organization>
    ...
  </organization>
  <organization>
    ...
  </organization>
</organizations>

Create

POST /organizations.xml
Creates a new organization.

Request

<organization>
  <name>Ajax Corp</name>
</organization>

Response

Status: 201
Location: {new-organization-id}.xml

Adds a organization with one agent as member.

Update

PUT /organizations/#{id}.xml
Updates an existing organization with new details from the submitted XML.

Request

<organization>
  <name>Ajax Mega Corp</name>
</organization>

Response

Status: 200

Destroy

DELETE /organizations/#{id}.xml
Destroys the organization at the referenced URL.

Response

Status: 200

Members of the organization

GET /organizations/#{id}/users.xml
Get a list of the members of an organization. This endpoint supports pagination of the users. For more information about the format of the users list see the Users API