# Criar, ativar e desativar times ## Como criar um time utilizando API? Para criar um time no Zeev utilizando API, siga os passos abaixo: 1. **Autenticação**: Primeiro obtenha um [token de autenticação](https://kb.zeev.it/apis/como-gerar-tokens-para-autenticar-nas-apis) com permissão de realizar essa operação; 2. **Defina os valores dos parâmetros:** Defina o nome, a descrição, o código original e a sigla do time que são respectivamente os valores de name, description, code e sign; 3. **Defina o valor de alwaysVisible:** Se for definido como **true** esse time aparecerá no menu lateral de "Acompanhar solicitações", mesmo que ele não possua nenhum aplicativo ou serviço disponível. 4. **Obtenha o parentId:** Se desejar informar um time superior hierarquicamente, obtenha antes o parentId que é o código identificador (teamid) do time hierarquicamente superior. É possível obtê-lo na página Acesso > Times ou através de consultas de API como explicado em [Listar times](/zeev/apis/all/access/teams/list.md); 5. **Obtenha o cityId:** Este é código identificador da cidade.É possível encontrar este valor consultando a página Avançado > Cidades ou através de consultas de API como explicado em [Outros](/zeev/apis/all/others.md#paises-estados-cidades). Para entender como a associação de uma cidade impacta o time consulte [Como criar times](/zeev/usuarios-e-permissoes/como-criar-times.md#turnos-de-trabalho-e-cidades); 6. **Obtenha o type:** Não é uma propriedade obrigatória mas ajuda a organizar e identificar os times. Não há no momento API's que possam listar os tipos de times disponíveis, você pode encontrar os valores na página Avançado > Tipos de times;; 7. Utilize o endpoint [#api-2-teams](#api-2-teams "mention") para enviar a requisição; {% openapi src="/files/DYIxvabeLXa2mL6uE2si" path="/api/2/teams" method="post" %} [ZeevApi's\_new.json](https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2Ff5huLIsAqm88oSjkTavv%2FZeevApi's_new.json?alt=media\&token=aae47f9f-90ca-48d0-b250-fc38fe74e6c0) {% endopenapi %} Exemplo de requisição para criar um time no Zeev {% tabs %} {% tab title="Node.js" %} ```javascript const myHeaders = new Headers(); myHeaders.append("Accept", "application/json"); myHeaders.append("Content-Type", "application/json"); myHeaders.append("Authorization", "Bearer TOKEN_DO_USUARIO"); const raw = JSON.stringify({ "name": "Projetos", "active": true, "alwaysVisible": true, "cityId": 14109, "code": "Pr0j3t0s-ab0", "description": "Time de projetos", "parentId": 64594592, "sign": "PJT", "type": 51564961 }); const requestOptions = { method: "POST", headers: myHeaders, body: raw }; try { const response = await fetch("https://seu_endereco.do.zeev/api/2/teams", requestOptions); const result = await response.json(); console.log(result) } catch (error) { console.error(error); }; ``` {% endtab %} {% endtabs %} *** ## Como ativar/desativar um time utilizando API? Para ativar ou desativar um time no Zeev utilizando API siga os passos abaixo: 1. **Autenticação**: Primeiro obtenha um [token de autenticação](https://kb.zeev.it/apis/como-gerar-tokens-para-autenticar-nas-apis) com permissão de realizar essa operação; 2. **Obter o teamId:** Obtenha o código identificador do time, você pode encontra-lo na página Acesso > Times ou no o resultado de consultas de API como explicado em [Listar times](/zeev/apis/all/access/teams/list.md); 3. **Enviar a requisição para:** 1. Ativar o time: [#api-2-teams-teamid-activate](#api-2-teams-teamid-activate "mention") 2. Desativar o time: [#api-2-teams-teamid-deactivate](#api-2-teams-teamid-deactivate "mention") Lembre-se de substituir seu\_endereco.do.zeev pelo endereço que você utiliza para acessar o Zeev. {% openapi src="/files/DYIxvabeLXa2mL6uE2si" path="/api/2/teams/{teamid}/activate" method="patch" %} [ZeevApi's\_new.json](https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2Ff5huLIsAqm88oSjkTavv%2FZeevApi's_new.json?alt=media\&token=aae47f9f-90ca-48d0-b250-fc38fe74e6c0) {% endopenapi %} {% openapi src="/files/DYIxvabeLXa2mL6uE2si" path="/api/2/teams/{teamid}/deactivate" method="patch" %} [ZeevApi's\_new.json](https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2Ff5huLIsAqm88oSjkTavv%2FZeevApi's_new.json?alt=media\&token=aae47f9f-90ca-48d0-b250-fc38fe74e6c0) {% endopenapi %} Exemplos de requisição para ativar/desativar um time? {% tabs %} {% tab title="Node.js (ativar time)" %} ```javascript let teamId = 751; const myHeaders = new Headers(); myHeaders.append("Accept", "application/json"); myHeaders.append("Authorization", "Bearer TOKEN_DO_USUARIO"); const requestOptions = { method: "PATCH", headers: myHeaders }; try { const response = await fetch(`https://seu_endereco.do.zeev/api/2/teams/${teamId}/activate`, requestOptions); const result = await response.text(); console.log(result) } catch (error) { console.error(error); }; ``` {% endtab %} {% tab title="Node.js (desativar time)" %} ```javascript let teamId = 751; const myHeaders = new Headers(); myHeaders.append("Accept", "application/json"); myHeaders.append("Content-Type", "application/json"); myHeaders.append("Authorization", "Bearer TOKEN_DO_USUARIO"); const requestOptions = { method: "PATCH", headers: myHeaders, redirect: "follow" }; try { const response = await fetch(`https://seu_endereco.do.zeev/api/2/teams/${teamId}/deactivate`, requestOptions); const result = await response.text(); console.log(result) } catch (error) { console.error(error); }; ``` {% endtab %} {% endtabs %} *** ## **Links relacionados**: * [O que é preciso para fazer integrações do Zeev para outros sistemas?](/zeev/integracoes/o-que-e-preciso-para-fazer-integracoes.md) * [Como autenticar nas APIs do Zeev](/zeev/apis/como-utilizar-as-apis-do-zeev/como-gerar-tokens-para-autenticar-nas-apis.md) * [Como controlar o volume máximo de requisições à APIs](/zeev/apis/como-utilizar-as-apis-do-zeev/como-controlar-o-volume-maximo-de-requisicoes-a-apis.md) * [Como acessar o Swagger / OpenAPI](/zeev/apis/como-utilizar-as-apis-do-zeev/como-acessar-o-swagger-openapi.md) * [Como criar times](/zeev/usuarios-e-permissoes/como-criar-times.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://kb.stoque.com.br/zeev/apis/all/access/teams/manage.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.