---
title: "Criar sessão de gestão do usuário final"
method: POST
path: "/open-keys/itp/api/v2/applications/{applicationId}/management/sessions"
tags: ["Gerenciamento de Aplicação"]
---

# Criar sessão de gestão do usuário final

`POST /open-keys/itp/api/v2/applications/{applicationId}/management/sessions`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/open-keys/itp/api/v2/applications/{applicationId}/management/sessions`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://keycloak.sandbox.shared.fsapps.io/auth/realms/openkeys-itp-v2-sandbox-dev/protocol/openid-connect/token` scopes: `user_owner_app`

Cria uma URL de sessão de gestão para fins de teste do usuário final. Isso gera uma sessão segura que permite aos usuários autorizados gerenciar e configurar definições da aplicação, testar cenários de usuário e executar tarefas administrativas dentro do contexto da aplicação.

## Path parameters

- `applicationId` string, required

## Request body

- ApplicationCreateManagementSession
  - `data` ApplicationCreateManagementSessionData, required
    - `userName` string: O nome do usuário que encontra-se logado
    - `loggedUser` ApplicationCreateManagementSessionDataLoggedUser, required
      - `document` UserDocument, required
        - `identification` string, required
        - `rel` string, required
    - `businessEntity` ApplicationCreateManagementSessionDataBusinessEntity
      - `document` BusinessDocument, required
        - `identification` string, required
        - `rel` string, required

## Response `200`

End user management session successfully returned.

- ManagementSession
  - `url` string, uri, required: Url da sessão de gestão do usuário final.

## Other responses

- `401`: É necessária autenticação para acessar este recurso. O cliente deve fornecer credenciais válidas.
- `403`: O servidor entendeu a solicitação, mas se recusa a autorizá-la. O acesso é permanentemente proibido e vinculado à lógica da aplicação.
- `409`: A solicitação está em conflito com o estado atual do recurso no servidor.
- `422`: A solicitação contém dados inválidos ou mal formados que não podem ser processados.
- `500`: Ocorreu um erro inesperado no servidor ao processar a solicitação.
- `default`: Erro inesperado.

---

[API](https://skmtc.dev/celcoin/apis/api-itp-v2.md) - [All operations](https://skmtc.dev/celcoin/apis/api-itp-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/api-itp-v2/revisions/be47794b8e2c?raw)