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

# Criar uma Aplicação

> Use este endpoint para criar as credenciais de cliente de uma integração máquina a máquina. O nome da aplicação identifica o produto ou plugin da Lerian que a integração vai acessar.



## OpenAPI

````yaml pt/openapi/v3-current/AM-identity.yaml post /v1/applications
openapi: 3.1.0
info:
  title: Plugin de Identidade
  description: ''
  version: 2.4.5
servers:
  - url: https://identity.sandbox.lerian.net
security: []
tags:
  - name: API de Grupos
  - name: API de Aplicações
  - name: API de Usuários
  - name: API de MFA
  - name: API de Provedores
  - name: API de Provedores de Aplicação
paths:
  /v1/applications:
    post:
      tags:
        - API de Aplicações
      summary: Criar uma Aplicação
      description: >-
        Use este endpoint para criar as credenciais de cliente de uma integração
        máquina a máquina. O nome da aplicação identifica o produto ou plugin da
        Lerian que a integração vai acessar.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationInput'
            example:
              description: Worker de conciliação do Bank Transfer.
              name: bank-transfer-worker
      responses:
        '201':
          description: >-
            Indica que o recurso foi criado com sucesso e a operação foi
            concluída conforme esperado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationResponse'
              example:
                clientId: 019c96a0-6a10-7abc-d1e2-8c9d0e1f2a3b
                clientSecret: 019c96a0-6a20-7bcd-e1f2-9d0e1f2a3b4c
                createdAt: '2025-04-08T08:01:30.000Z'
                description: Worker de conciliação do Bank Transfer.
                id: 019c96a0-0c0c-7221-8cf3-13313fb60081
                name: bank-transfer-worker
          headers: {}
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
              examples:
                Error0001:
                  $ref: '#/components/examples/Error0001'
                Error0002:
                  $ref: '#/components/examples/Error0002'
                Error0004:
                  $ref: '#/components/examples/Error0004'
                Error0007:
                  $ref: '#/components/examples/Error0007'
                Error0012:
                  $ref: '#/components/examples/Error0012'
          headers: {}
        '500':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
              examples:
                Error0006:
                  $ref: '#/components/examples/Error0006'
          headers: {}
      security:
        - bearer: []
components:
  schemas:
    ApplicationInput:
      description: Informações usadas para criar uma aplicação máquina a máquina.
      type: object
      required:
        - description
        - name
      properties:
        description:
          description: >-
            Identificador claro que ajuda você a reconhecer rapidamente qual
            serviço, job ou integração usa a aplicação.
          type: string
        name:
          type: string
          description: >-
            O produto ou plugin da Lerian que esta aplicação máquina a máquina
            vai acessar.
    ApplicationResponse:
      description: Informações sobre a Aplicação.
      type: object
      properties:
        clientId:
          type: string
          description: Identificador único do cliente.
        clientSecret:
          type: string
          description: >-
            Chave secreta vinculada ao `clientId`, usada para autenticação
            segura do cliente.
        createdAt:
          type: string
          format: date-time
          description: Registro de data e hora de quando a aplicação foi criada.
        description:
          description: >-
            Identificador claro que ajuda você a reconhecer rapidamente qual
            serviço, job ou integração usa a aplicação.
          type: string
        id:
          type: string
          description: Identificador único da aplicação.
        name:
          type: string
          description: >-
            O produto ou plugin da Lerian que esta aplicação máquina a máquina
            pode acessar.
    ErrorMessage:
      description: A mensagem de erro da resposta.
      type: object
      properties:
        code:
          type: string
          description: Um identificador único e estável para o erro.
        title:
          type: string
          description: Um breve resumo do problema.
        message:
          type: string
          description: Orientação detalhada para resolver o erro.
  examples:
    Error0001:
      summary: Missing Fields in Request
      value:
        code: IDE-0001
        title: Missing Fields in Request
        message: Your request is missing one or more required fields.
    Error0002:
      summary: Invalid Field Type in Request
      value:
        code: IDE-0002
        title: Invalid Field Type in Request
        message: The provided field type in the request is invalid.
    Error0004:
      summary: Unexpected Fields in the Request
      value:
        code: IDE-0004
        title: Unexpected Fields in the Request
        message: >-
          The request body contains more fields than expected. Please send only
          the allowed fields.
    Error0007:
      summary: Bad Request
      value:
        code: IDE-0007
        title: Bad Request
        message: The server could not understand the request due to malformed syntax.
    Error0012:
      summary: Invalid Application Name
      value:
        code: IDE-0012
        title: Invalid Application Name
        message: The provided application name is invalid.
    Error0006:
      summary: Internal Server Error
      value:
        code: IDE-0006
        title: Internal Server Error
        message: The server encountered an unexpected error. Please try again later.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: O token de autorização no formato 'Bearer <token>'.

````