---
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: `https://sandbox.openfinance.celcoin.dev`
- URL: `https://sandbox.openfinance.celcoin.dev/open-keys/itp/api/v2/applications/{applicationId}/management/sessions`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `http://localhost:8080/auth/realms/master/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: CPF number of the natural person, composed of 11 numeric digits without dots, dashes or spaces. Must be a valid CPF according to the Brazilian Federal Revenue validation algorithm.
        - `rel` string, required: Type of identification document. For Brazilian natural persons, always 'CPF' (Individual Taxpayer Registry). Identifies the type of document presented in the identification field.
    - `businessEntity` ApplicationCreateManagementSessionDataBusinessEntity
      - `document` BusinessDocument, required
        - `identification` string, required: CNPJ number of the legal entity, composed of 14 numeric digits without dots, slashes or spaces. Must be a valid CNPJ according to the Brazilian Federal Revenue validation algorithm.
        - `rel` string, required: Type of identification document. For Brazilian legal entities, always 'CNPJ' (National Registry of Legal Entities). Identifies the type of document presented in the identification field.

## 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`: Authentication is required to access this resource. The client must provide valid credentials.
- `403`: The server understood the request but refuses to authorize it. Access is permanently forbidden and tied to the application logic.
- `409`: The request conflicts with the current state of the resource on the server.
- `422`: The request contains invalid or malformed data that cannot be processed.
- `500`: An unexpected error occurred on the server while processing the request.
- `default`: Unexpected error.

---

[API](https://skmtc.dev/celcoin/apis/api-para-transa-es.md) - [All operations](https://skmtc.dev/celcoin/apis/api-para-transa-es/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/api-para-transa-es/revisions/85dd6188a37b?raw)