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

# Obter Função Por ID

> Endpoint para obter uma função pelo ID

## Token de Acesso

<ParamField header="Authorization" type="string">
  Token de acesso ("Bearer" deve estar antes do token)
</ParamField>

## Corpo da Requisição

<ParamField path="id" type="string" required="true" placeholder="Enter with FunctionId">
  ID da Função a ser obtida
</ParamField>

### Descrição da Resposta

O endpoint retorna uma resposta em JSON com a confirmação da solicitação.

<ResponseField name="items" type="array" required>
  Lista de plugins recuperados.

  <Expandable title="Items">
    <ResponseField name="id" type="string" required>
      Identificador único do plugin.
    </ResponseField>

    <ResponseField name="institutionId" type="string" required>
      ID da instituição associada.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Nome do plugin.
    </ResponseField>

    <ResponseField name="description" type="string" required>
      Descrição do plugin.
    </ResponseField>

    <ResponseField name="code" type="string" required>
      Código que define a funcionalidade do plugin.
    </ResponseField>

    <ResponseField name="status" type="boolean" required>
      Indica se o plugin está habilitado.
    </ResponseField>

    <ResponseField name="unityId" type="string" required>
      ID da unidade associada.
    </ResponseField>

    <ResponseField name="userId" type="string" required>
      ID do usuário que criou ou gerencia o plugin.
    </ResponseField>

    <ResponseField name="iconFileId" type="string">
      ID opcional do arquivo de ícone do plugin.
    </ResponseField>

    <ResponseField name="color" type="string" required>
      Cor associada ao plugin para fins de UI.
    </ResponseField>

    <ResponseField name="outputs" type="array">
      Lista de outputs do plugin (vazio se não existirem).
    </ResponseField>

    <ResponseField name="pluginIcon" type="string">
      URL ou detalhes opcionais do ícone do plugin.
    </ResponseField>

    <ResponseField name="isActivated" type="boolean" required>
      Indica se o plugin está ativado.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pluginCount" type="number" required>
  Número total de plugins disponíveis.
</ResponseField>

<ResponseField name="activeCount" type="number" required>
  Número de plugins ativos.
</ResponseField>

<ResponseField name="pluginLimit" type="number" required>
  Número máximo de plugins permitidos.
</ResponseField>

## Segurança

Para acessar este endpoint, é necessário enviar um **token de acesso** válido através do cabeçalho de autorização (Authorization) da requisição. Além disso, a API é protegida por outras medidas de segurança para proteger os dados dos usuários.

### Erros

Exemplos de erro de segurança

<Expandable title="error 🚦">
  <ResponseField name="200" type="string">
    Resposta de sucesso da requisição
  </ResponseField>

  <ResponseField name="500" type="string">
    Falha na requisição
  </ResponseField>
</Expandable>