> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar acesso a um app do Studio

> Substitui com quem um app do Studio é compartilhado na empresa atual: quem não estiver nas listas perde o acesso ao app. Enviar as duas listas vazias encerra o compartilhamento. Chamado pelo Studio depois de confirmar que quem pede é o dono do app; exige acesso ao Studio e responde com a lista atualizada.



## OpenAPI

````yaml /api-reference/openapi.json put /api/management/apps/{appKey}/access
openapi: 3.0.0
info:
  title: Olie API
  version: 1.0.0
  description: >
    # Introdução 👋


    Olá! Esta é a documentação oficial da API da [olie.ai](https://olie.ai/).
    Aqui você encontra as referências e exemplos de uso dos nossos endpoints.


    Para uma visão completa, recomendamos fortemente que você leia a
    [documentação oficial](https://docs.olie.ai/api-reference/introduction). Lá
    estão detalhados tópicos essenciais como
    [autenticação](https://docs.olie.ai/api-reference/introduction/authentication),
    [estrutura de
    respostas](https://docs.olie.ai/api-reference/general/response-structure),
    [paginação](https://docs.olie.ai/api-reference/general/pagination) e outros
    guias de integração.


    No Postman, esta coleção foca nas informações específicas de cada requisição
    (endpoints, parâmetros e exemplos), servindo como apoio rápido para testes e
    desenvolvimento.
servers:
  - url: https://api.olie.ai
security:
  - BearerAuth: []
paths:
  /api/management/apps/{appKey}/access:
    parameters:
      - name: appKey
        in: path
        required: true
        description: >-
          Chave do app no Studio: de 1 a 50 caracteres entre letras minúsculas,
          números e hífen (ex.: crm, inbox-sdr).
        schema:
          type: string
        example: ''
    put:
      tags:
        - studio
      summary: Atualizar acesso a um app do Studio
      description: >-
        Substitui com quem um app do Studio é compartilhado na empresa atual:
        quem não estiver nas listas perde o acesso ao app. Enviar as duas listas
        vazias encerra o compartilhamento. Chamado pelo Studio depois de
        confirmar que quem pede é o dono do app; exige acesso ao Studio e
        responde com a lista atualizada.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                user_ids:
                  type: array
                  items: {}
                role_ids:
                  type: array
                  items: {}
            example:
              user_ids: []
              role_ids: []
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: boolean
                  access:
                    type: object
                    properties:
                      users:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            email:
                              type: string
                              format: email
                      roles:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                            name:
                              type: string
              examples:
                Sucesso:
                  value:
                    response: true
                    access:
                      users:
                        - id: 7d1e4b2a-3c5f-4e8a-9b1d-2f6a8c0e4b71
                          name: Ana Ribeiro
                          email: ana.ribeiro@exemplo.com.br
                      roles:
                        - id: 12
                          name: Atendimento
                Compartilhamento encerrado:
                  value:
                    response: true
                    access:
                      users: []
                      roles: []
        '403':
          description: Sem acesso ao Studio
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: boolean
                  message:
                    type: string
                  error:
                    type: string
                  permission:
                    type: string
              example:
                response: false
                message: permission_required
                error: An permission is required to that action
                permission: studio.access
        '422':
          description: Validação falhou
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: boolean
                  message:
                    type: string
                  error:
                    type: string
                  validation:
                    type: object
                    properties:
                      user_ids.0:
                        type: array
                        items:
                          type: string
                      role_ids.0:
                        type: array
                        items:
                          type: string
              example:
                response: false
                message: validation_errors
                error: The selected user_ids.0 is invalid. (and 1 more error)
                validation:
                  user_ids.0:
                    - The selected user_ids.0 is invalid.
                  role_ids.0:
                    - The selected role_ids.0 is invalid.
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.