> ## Documentation Index > Fetch the complete documentation index at: https://docsnewgen.flexxible.com/llms.txt > Use this file to discover all available pages before exploring further. # Criar um tenant > Cria um novo tenant e uma organização associada para a organização proprietária especificada. O corpo da solicitação usa um discriminador `type` com rotas exclusivas: `tenant` (CLIENTE FINAL) e `organization` (PARCEIRO/ATACADISTA). ## OpenAPI ````yaml /pt-BR/api-reference/openapi.pt-v2.json post /v2/organizations/{organization_id}/tenants openapi: 3.0.3 info: title: API Publica Portal version: 2.0.0 description: API pública REST para portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: - name: Atividade digital description: Criação de grupos de processos principais por organização - name: Roles description: Endpoint de creacion de roles de organizacion - name: Usuarios description: Endpoint de creacion de usuarios de organizacion - name: Grupos de workspaces description: Endpoints de gestión de grupos de workspaces - name: Workspaces description: Endpoint de eliminacion de workspaces de la organizacion - name: Aplicaciones instaladas description: Endpoint de detalle de aplicación instalada de la organización - name: Autenticación description: Endpoints de autenticación y contexto de sesión - name: Microservicios description: Detalle de microservicios por organizacion - name: Operaciones description: Consulta de detalle de operaciones por organización - name: Organización description: Operaciones de organización - name: Objetivos de política de parches description: Endpoints de gestión de objetivos de política de parches - name: Configuraciones de producto description: Endpoints de gestión de configuraciones de producto - name: Grupos de reporte description: Operaciones sobre grupos de reporte - name: Sesiones description: Endpoint de detalle de sesion de la organizacion - name: Tenants description: Endpoints de gestión de tenants paths: /v2/organizations/{organization_id}/tenants: post: tags: - Locatários summary: Criar um tenant description: >- Cria um novo tenant e uma organização associada para a organização proprietária especificada. O corpo da solicitação usa um discriminador `type` com rotas exclusivas: `tenant` (CLIENTE FINAL) e `organization` (PARCEIRO/ATACADISTA). operationId: createTenant parameters: - name: organization_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: >- O identificador único da organização proprietária que criará o tenant example: 507f1f77bcf86cd799439011 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateTenantRequestV2' examples: create-tenant-end-customer: summary: Criar tenant para organização CLIENTE FINAL value: type: tenant name: Tenant de producción tenant_config: product_config_id: 507f1f77bcf86cd799439030 analyzer: existing policy_id: 507f1f77bcf86cd799439050 organization_email: tenant@example.com organization_language: en organization_country: US organization_industry: Tecnología create-tenant-partner-or-wholesaler: summary: Criar tenant para organização PARCEIRO ou ATACADISTA value: type: organization name: Tenant empresarial organization_config: product_id: 507f1f77bcf86cd799439030 region: west-eu-01_one policy_id: 507f1f77bcf86cd799439050 organization_email: enterprise@example.com organization_language: es organization_country: ES organization_industry: Finanzas responses: '201': description: >- Tenant e organização associados criados corretamente. Retorna o recurso tenant criado. content: application/json: schema: $ref: '#/components/schemas/TenantByIdV2' '400': $ref: '#/components/responses/BadRequest' description: >- Solicitação incorreta. Causas comuns: - Corpo de solicitação ou parâmetros de rota inválidos - Configurações exclusivas misturadas (`tenant_config` e `organization_config`) - Campos obrigatórios ausentes para o tipo selecionado - Formato de id inválido '401': $ref: '#/components/responses/Unauthorized' description: Não autorizado - é necessária autenticação '404': $ref: '#/components/responses/NotFound' description: Organização proprietária não encontrada '422': description: >- Entidade não processável - Erro de validação de lógica de negócio. Causas comuns: - Configuração do produto não encontrada - A organização não é elegível para criar tenants - A organização não existe em build - A organização não tem produtos elegíveis - Relação de parceiro inválida - A organização e a organização mãe são clientes finais - Entidade referenciada não encontrada content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CreateTenantRequestV2: type: object additionalProperties: false properties: type: type: string enum: - tenant - organization description: >- Tipo de criação. `tenant` para CLIENTE FINAL, `organization` para PARCEIRO/ATACADISTA. name: type: string maxLength: 512 tenant_config: type: object additionalProperties: false nullable: true description: Configuração específica para `type=tenant`. properties: product_config_id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ analyzer: type: string enum: - existing - new required: - product_config_id - analyzer organization_config: type: object additionalProperties: false nullable: true description: Configuração específica para `type=organization`. properties: product_id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ region: type: string maxLength: 128 required: - product_id - region policy_id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ organization_email: type: string maxLength: 512 organization_language: type: string maxLength: 512 organization_country: type: string maxLength: 512 organization_industry: type: string maxLength: 512 required: - type - name - organization_email - organization_language - organization_country - organization_industry description: >- Corpo único de criação com campos condicionais por `type`: se `type=tenant`, requer `tenant_config`; se `type=organization`, requer `organization_config`. TenantByIdV2: type: object required: - id - organization_id - created_at - name - region properties: id: type: string organization_id: type: string description: ID da organização do tenant created_at: type: string format: date-time name: type: string region: type: string product_id: type: string nullable: true description: ID do produto policy_id: type: string nullable: true description: ID da política ErrorResponse: type: object properties: error: type: object properties: message: type: string code: type: string details: type: string required: - message - code required: - error responses: BadRequest: description: Solicitação incorreta content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: Não autorizado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: Não encontrado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' TooManyRequests: description: Solicitações em excesso content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Erro interno do servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````