# REST Resource: projects.tenants

- [Resource: Tenant](https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants#Tenant)
  - [JSON representation](https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants#Tenant.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants#METHODS_SUMMARY)

## Resource: Tenant

A Tenant resource represents a tenant in the service. A tenant is a group or entity that shares common access with specific privileges for resources like jobs. Customer may create multiple tenants to provide data isolation for different groups.

| JSON representation |
|---|
| ``` { "name": string, "externalId": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Required during tenant update. The resource name for a tenant. This is generated by the service when a tenant is created. The format is "projects/{projectId}/tenants/{tenantId}", for example, "projects/foo/tenants/bar". |
| `externalId` | `string` Required. Client side tenant identifier, used to uniquely identify the tenant. The maximum number of allowed characters is 255. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants/completeQuery` | Completes the specified prefix with keyword suggestions. |
| ### `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants/create` | Creates a new tenant entity. |
| ### `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants/delete` | Deletes specified tenant. |
| ### `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants/get` | Retrieves specified tenant. |
| ### `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants/list` | Lists all tenants associated with the project. |
| ### `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants/patch` | Updates specified tenant. |