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

# Create or register a time event



## OpenAPI

````yaml /api-reference/tempo.yaml post /v2/time-clock
openapi: 3.0.0
info:
  title: Tarefy API
  description: >-
    Tarefy REST API — task management, culture and performance platform.


    Endpoints are versioned at `/v2/...`. Authentication via Bearer JWT in the
    `Authorization` header.


    To get started, see the [authentication guide](/authentication) and the
    [quickstart](/quickstart).
  version: 2.0.0
  contact:
    name: Tarefy Support
    email: suporte@tarefy.com
    url: https://tarefy.com
  license:
    name: Proprietary
    url: https://tarefy.com
servers:
  - url: https://app.tarefy.com/nodeapi
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Time Clock
    description: Electronic time — work record
  - name: Time Clock Justifys
    description: Time justifications
  - name: Time Bank
    description: Time bank
  - name: Off Time
    description: Days off and absences
  - name: Vacations
    description: Vacation — granting and management
paths:
  /v2/time-clock:
    post:
      tags:
        - Time Clock
      summary: Create or register a time event
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                origin:
                  type: string
                  example: web
                location:
                  type: object
                  description: >-
                    Obrigatório em dia presencial quando a configuração de
                    geolocalização do ponto estiver ativa.
                  properties:
                    latitude:
                      type: number
                      example: -23.5617
                    longitude:
                      type: number
                      example: -46.6254
                    accuracy:
                      type: number
                      description: Precisão informada pelo navegador em metros.
                      example: 12
                geofence_confirmation:
                  type: object
                  description: >-
                    Enviado na segunda chamada quando a primeira resposta exigir
                    confirmação de batida fora da área em dia presencial.
                  properties:
                    confirmed:
                      type: boolean
                      example: true
      responses:
        '200':
          description: >-
            Registro de ponto criado com sucesso ou confirmação de geofence
            solicitada
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    description: >-
                      Identificador da batida criada quando não há confirmação
                      pendente.
                    example: 123
                  requires_geofence_confirmation:
                    type: boolean
                    description: >-
                      Quando true, nenhuma batida foi criada e o cliente deve
                      reenviar com geofence_confirmation.confirmed=true.
                    example: true
                  geofence:
                    type: object
                    nullable: true
                    properties:
                      status:
                        type: string
                        enum:
                          - outside
                        example: outside
                      distance_meters:
                        type: integer
                        nullable: true
                        example: 480
                      radius_meters:
                        type: integer
                        nullable: true
                        example: 100
                      reference:
                        type: object
                        properties:
                          latitude:
                            type: number
                            nullable: true
                            example: -23.6190278
                          longitude:
                            type: number
                            nullable: true
                            example: -46.6995833
                          address:
                            type: string
                            nullable: true
                            example: Sede Tarefy
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````