> ## Documentation Index
> Fetch the complete documentation index at: https://developers.pontua.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Cria um novo cargo



## OpenAPI

````yaml https://api.pre.pontua.tech/api/public/doc-json post /cargos
openapi: 3.0.0
info:
  title: Pontua Public API
  description: >-
    API oficial da Pontua para integrações de clientes externos. Autentique com
    o token gerado no dashboard em **Configurações → API**. Envie o token no
    header `Authorization: Bearer <SEU_TOKEN>`.
  version: '1.0'
  contact: {}
servers: []
security: []
tags: []
paths:
  /cargos:
    post:
      tags:
        - Cargo
      summary: Cria um novo cargo
      operationId: CargosController_CriarCargo
      parameters: []
      requestBody:
        required: true
        description: Dados do cargo
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CriarCargoDto'
            examples:
              Cargo:
                value:
                  nome: Diretor Financeiro
              Cargo com CBO:
                value:
                  nome: Diretor Financeiro
                  codigoCbo: '10105'
              Cargo vinculado:
                value:
                  nome: Diretor Financeiro
                  unidadeNegocioId: unidade-id
              Cargo com código:
                value:
                  nome: Diretor Financeiro
                  codigo: 1000
              Cargo com código e vinculado:
                value:
                  nome: Diretor Financeiro
                  codigo: 1000
                  unidadeNegocioId: unidade-id
              Cargo todas as informações:
                value:
                  nome: Diretor Financeiro
                  codigo: 1000
                  unidadeNegocioId: unidade-id
                  codigoCbo: '10105'
              Cargo forçando o NÃO vinculado (only edit):
                value:
                  nome: Diretor Financeiro
                  unidadeNegocioId: null
      responses:
        '201':
          description: Cargo criado com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CargoDto'
              examples:
                'Cargo ':
                  value:
                    cargoId: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
                    nome: Diretor
                    codigo: 5
                    ativo: true
                Cargo Vinculado:
                  value:
                    cargoId: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
                    nome: Diretor
                    codigo: 5
                    ativo: true
                    unidadeNegocioId: 1b88e4f3-04bf-4185-b782-9211e4b6bca4
                    unidadeNegocio:
                      unidadeNegocioId: 1b88e4f3-04bf-4185-b782-9211e4b6bca4
                      nome: Pontua Matriz
                      numeroCadastro: '12345678912'
                Cargo com CBO:
                  value:
                    cargoId: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
                    nome: Diretor
                    codigo: 5
                    ativo: true
                    codigoCbo: '123115'
                    codigoCboDescricao: Diretor financeiro
                Cargo completo:
                  value:
                    cargoId: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
                    nome: Diretor
                    codigo: 5
                    ativo: true
                    codigoCbo: '123115'
                    codigoCboDescricao: Diretor financeiro
                    unidadeNegocioId: 1b88e4f3-04bf-4185-b782-9211e4b6bca4
                    unidadeNegocio:
                      unidadeNegocioId: 1b88e4f3-04bf-4185-b782-9211e4b6bca4
                      nome: Pontua Matriz
                      numeroCadastro: '12345678912'
                    colaboradores: 10
        default:
          description: "\n\t\t\t400 - Bad Request: A solicitação não está no formato correto.\n\t\t\t401 - Unauthorized: A solicitação não foi autorizada. Verifique se o token de acesso é válido.\n\t\t\t403 - Forbidden: Acesso proibido! Requer um nível de permissão mais elevado.\n\t\t\t404 - Not Found: O recurso solicitado não foi encontrado.\n\t\t\t500 - Internal Server Error: Erro de execução no servidor!\n\t\t\t"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
      deprecated: false
      security:
        - bearer: []
components:
  schemas:
    CriarCargoDto:
      type: object
      properties:
        nome:
          type: string
          description: Nome do cargo
          example: Diretor Financeiro
        codigo:
          type: number
          description: Código do cargo.
          example: 5
        codigoCbo:
          type: string
          description: Código CBO referente ao cargo
          example: '10105'
        unidadeNegocioId:
          type: string
          description: ID referente a unidade de negócio
          example: 1b88e4f3-04bf-4185-b782-9211e4b6bca4
      required:
        - nome
    CargoDto:
      type: object
      properties:
        cargoId:
          type: string
          description: ID referente ao cargo
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        nome:
          type: string
          description: Nome do cargo
          example: Diretor
        codigo:
          type: number
          description: Código númerico do cargo
          example: 5
        ativo:
          type: boolean
          description: Status do cargo
          example: true
        codigoCbo:
          type: string
          description: Código CBO selecionado
          example: '123115'
        codigoCboDescricao:
          type: string
          description: Descrição do Código CBO selecionado
          example: Diretor financeiro
        unidadeNegocioId:
          type: string
          description: ID referente a unidade de negócio
          example: 1b88e4f3-04bf-4185-b782-9211e4b6bca4
        unidadeNegocio:
          description: Unidade de negocio pertencente
          allOf:
            - $ref: '#/components/schemas/UnidadeNegocio'
        colaboradores:
          type: number
          description: Quantidade de colaboradores vinculados ao cargo
          example: 10
      required:
        - cargoId
        - nome
        - codigo
        - ativo
        - colaboradores
    ErrorDto:
      type: object
      properties:
        service:
          type: string
          description: Rota solicitada
        method:
          type: string
          description: Método http
        message:
          description: Mensagem do erro
          oneOf:
            - type: string
              example: message erro
            - type: array
              items:
                type: string
                example:
                  - erro 1
                  - erro 2
      required:
        - service
        - method
        - message
    UnidadeNegocio:
      type: object
      properties:
        unidadeNegocioId:
          type: string
          description: ID referente a unidade de negócio
          example: 1b88e4f3-04bf-4185-b782-9211e4b6bca4
        nome:
          type: string
          description: nome da unidade de negócio
          example: Pontua Matriz
        numeroCadastro:
          type: string
          description: Número cadastrado da unidade de negócio
          example: '12345678912'
        logo:
          type: string
          description: Caminho da logo da unidade de negócio
          example: //logo.png
      required:
        - unidadeNegocioId
        - nome
        - numeroCadastro

````