--- title: "Guia da API do operador" slug: "using-the-operator-api" updated: 2026-10-22T14:34:44Z published: 2026-10-22T14:34:44Z canonical: "support.tulip.co/using-the-operator-api" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Guia da API do operador *Saiba como configurar a API do Operador* Advanced Content This article assumes previous experience with APIs. É necessário adicionar operadores ao seu site para preencher a lista de usuários que executarão os aplicativos desenvolvidos no Tulip. Você pode criar operadores de duas maneiras:* [Na página “Usuários”](https://support.tulip.co/docs/adding-users-and-managing-user-roles), localizada em **“Configurações”*** Usando um sistema externo por meio da API do Tulip. O procedimento abaixo demonstra como usar a API do Tulip para criar operadores. ## Adicionar um token da API do Operador Feature rename Prior to r383, Service Accounts were called "API Tokens". Na sua instância do Tulip, clique **no ícone do** seu **perfil** no canto superior direito e selecione **“Configurações**”. ![Configuring Your Tulip Account Settings_124925135](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Configuring%20Your%20Tulip%20Account%20Settings_124925135.png) Selecione **API do Tulip** e clique no botão **“Criar conta de serviço** ” no canto superior direito. ![Create%20API%20token1](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20token1.png) No menu Criação, dê um **nome** ao token da API e selecione o escopo `users:write`. Clique em **Criar**. ![Create API Token](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20Token.gif) Note Make sure to save the Service Account information for the **API Key**, **Secret**, and **Authorization Header**. ## Usando a API do Operador A seguir, explicaremos como criar um operador. Neste caso, o exemplo utilizará [o Postman](https://www.postman.com/) para realizar a criação. Primeiro, adicione seu endpoint da API à solicitação POST. NOTE If you are using a global API key, you need to specify the workspace. If your API key is workspaced scoped, it is optional. *https://(nome da sua instância aqui).tulip.co/api/v3/w/(workspace)/users* ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222496924.png) Em seguida, na seção “Autorização”, selecione **“Autenticação Básica** ” e insira a chave da API como **“Nome de usuário**” e o segredo da API como **“Senha**”. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497720.png) Em “Headers”, adicione o **cabeçalho “Auth**”. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497957.png) No Corpo, formate a solicitação para incluir o objeto JSON. O formato genérico para essa solicitação é o seguinte. `{"role": "operator","name": "string","badge_id": "string"}` Ficará mais ou menos assim: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222499033.png) Clique em **“Enviar”** para executar a solicitação e você receberá uma resposta 201 indicando sucesso. Para verificar, você pode conferir sua lista de “Usuários” em **“Configurações”** e confirmar se o usuário foi criado com sucesso. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222499593.png) Se a solicitação falhar, verifique se a Chave e o Segredo estão corretos. Para obter mais informações sobre códigos de resposta específicos, consulte [Introdução às APIs](/r230/docs/introduction-to-apis). --- Você encontrou o que estava procurando? Você também pode acessar [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) para postar sua dúvida ou ver se outras pessoas já tiveram uma dúvida semelhante! **JSON** **JSON (JavaScript Object Notation)** is a light-weight, text-based data format that is used to store and transfer data.