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

# Criar apontamento de um item existente



## OpenAPI

````yaml https://api.juridiq.com.br/api-docs/client/openapi.json post /time-sheet/
openapi: 3.1.0
info:
  title: Juridiq API — Documentação para Integradores
  description: ''
  version: 1.0.0
servers:
  - url: https://api.juridiq.com.br
    description: Production server
security:
  - apiKeyAuth: []
tags: []
paths:
  /time-sheet/:
    post:
      tags:
        - TimeSheets
      summary: Criar apontamento de um item existente
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                module:
                  type: string
                  enum:
                    - TASK
                    - AUDIENCE
                    - SUBTASK
                    - GENERAL
                  description: Módulo do apontamento
                id:
                  type: string
                  format: uuid
                  description: >-
                    ID da tarefa/subtarefa/audiência (obrigatório, exceto
                    GENERAL)
                title:
                  type: string
                  minLength: 1
                  description: Título do apontamento (obrigatório para GENERAL)
                status:
                  type: string
                  enum:
                    - PENDING
                    - IN_PROGRESS
                    - PAUSED
                    - COMPLETED
                    - CANCELLED
                  description: Status inicial (apenas GENERAL; padrão PENDING)
                estimatedTimeMinutes:
                  type: integer
                  minimum: 0
                  description: Tempo previsto em minutos (apenas GENERAL)
              required:
                - module
              additionalProperties: false
              description: Cria o apontamento (TimeSheet) de um item já existente
        required: true
        description: Cria o apontamento (TimeSheet) de um item já existente
      responses:
        '201':
          description: Apontamentos criados/relacionados ao item
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: ID do apontamento
                    title:
                      type: string
                      description: Título
                    module:
                      type: string
                      enum:
                        - TASK
                        - AUDIENCE
                        - SUBTASK
                        - GENERAL
                      description: Módulo
                    isDone:
                      type: boolean
                      description: Concluído
                    status:
                      type: string
                      enum:
                        - PENDING
                        - IN_PROGRESS
                        - PAUSED
                        - COMPLETED
                        - CANCELLED
                      nullable: true
                      description: Status atual
                    officeId:
                      type: string
                      description: ID do escritório
                    userId:
                      type: string
                      nullable: true
                      description: ID do usuário
                    taskId:
                      type: string
                      nullable: true
                      description: ID da tarefa
                    audienceId:
                      type: string
                      nullable: true
                      description: ID da audiência
                    subtaskId:
                      type: string
                      nullable: true
                      description: ID da subtarefa
                    estimatedTimeMinutes:
                      type: number
                      nullable: true
                      description: Tempo estimado (minutos)
                    timeSpentSeconds:
                      type: number
                      description: Tempo gasto somando os históricos (segundos)
                    cancelReason:
                      type: string
                      nullable: true
                      description: Motivo do cancelamento
                    completedAt:
                      type: string
                      format: date-time
                      nullable: true
                      description: Data de finalização (conclusão/cancelamento)
                    vinculateItem:
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID do item vinculado
                        name:
                          type: string
                          description: Nome/título do item vinculado
                        processNumber:
                          type: string
                          nullable: true
                          description: Número do processo vinculado
                      required:
                        - id
                        - name
                      additionalProperties: false
                      nullable: true
                      description: Item vinculado (tarefa/subtarefa/audiência)
                    thisUserCanEdit:
                      type: boolean
                      description: >-
                        Indica se o usuário da requisição é o dono do
                        apontamento
                    userDetail:
                      type: object
                      properties:
                        name:
                          type: string
                          description: Nome do usuário
                        urlImage:
                          type: string
                          nullable: true
                          description: URL da imagem do usuário
                      required:
                        - name
                      additionalProperties: false
                      nullable: true
                      description: Dados do usuário do apontamento
                    statusHistories:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            type: string
                            description: ID do histórico
                          description:
                            type: string
                            nullable: true
                            description: Descrição
                          status:
                            type: string
                            enum:
                              - PENDING
                              - IN_PROGRESS
                              - PAUSED
                              - COMPLETED
                              - CANCELLED
                            description: Status
                          startedAt:
                            type: string
                            format: date-time
                            description: Início do status
                          endedAt:
                            type: string
                            format: date-time
                            nullable: true
                            description: Fim do status
                          timeSpent:
                            type: number
                            nullable: true
                            description: Tempo gasto (segundos)
                          createdAt:
                            type: string
                            format: date-time
                            description: Data de criação
                          updatedAt:
                            type: string
                            format: date-time
                            description: Data de atualização
                        required:
                          - id
                          - status
                          - startedAt
                          - createdAt
                          - updatedAt
                        additionalProperties: false
                      description: Históricos de status
                    createdAt:
                      type: string
                      format: date-time
                      description: Data de criação
                    updatedAt:
                      type: string
                      format: date-time
                      description: Data de atualização
                  required:
                    - id
                    - title
                    - module
                    - isDone
                    - officeId
                    - timeSpentSeconds
                    - createdAt
                    - updatedAt
                  additionalProperties: true
                description: Apontamentos criados/relacionados ao item
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  translateMessage:
                    type: string
                required:
                  - message
                  - statusCode
                  - translateMessage
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  translateMessage:
                    type: string
                required:
                  - message
                  - statusCode
                  - translateMessage
                additionalProperties: false
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-juridiq-api-key
      description: >-
        Chave de API do escritório (criada no painel). Envie o valor no header
        x-juridiq-api-key.

````