# Deep Security Manager REST API

## Path: / rest / tenants

Retrieve information about all tenants.

Resources
Name | Description
--- | ---
id ↳ id/{tID} | Retrieve a tenant by tenant's ID.
name ↳ name/{tName} | Retrieve a tenant by name.
state ↳ state/{state} | Get tenants by tenant state

Method Summary
Resource | Description
--- | ---
`GET /rest/tenants?sID=…` | Retrieve information about all tenants.
`POST /rest/tenants` | Add a new tenant.

Method Detail
Retrieve information about all tenants. Output: `TenantListing` - The collection of tenants. Query parameters: sID - a session ID returned by the Authentication API. Produces: application/xml application/json
Add a new tenant. Input: `CreateTenantRequest` - contains options to be used for the creation of the new tenant. Output: `CreateTenantResponse` - A response with status `200 OK` and a body containing tenant details when adding the tenant succeeds. If parameter validation fails, it will return a response with status `400 Bad Request` and a body containing an `ErrorMessage`. If parameter validation succeeds but creation of the tenant fails, the tenant will be left in a partially created state, and will need to be deleted. Produces: application/xml application/json Consumes: application/xml application/json

Copyright © 2017 Trend Micro Inc. All Rights Reserved.