---
title: "Atualizar uma execução"
method: PUT
path: "/api/management/projects/{project_id}/project-executions/{project_execution_id}"
tags: ["projects", "Execuções"]
---

# Atualizar uma execução

`PUT /api/management/projects/{project_id}/project-executions/{project_execution_id}`

Ajusta os horários de uma execução ou a encerra imediatamente. Envie `finish_now` como `true` para parar a contagem agora — nesse caso `started_at` e `finished_at` não podem ser enviados.

Corrigir horários exige permissão de edição da execução, enquanto encerrar a própria contagem não. Tokens de aplicação não podem atualizar execuções.

## Request body

- object — Ajuste da execução. Envie os horários ou `finish_now`, nunca os dois.
  - `started_at` string, date-time, nullable — Novo horário de início.
  - `finished_at` string, date-time, nullable — Novo horário de término. Precisa ser depois do início.
  - `finish_now` boolean — `true` encerra a execução agora. Não pode ser combinado com os horários.

## Response `200`

Encerrada agora

- object — Execução devolvida sob a chave `data`.
  - `data` object, required — Registro de tempo de trabalho.
    - `id` string, uuid — ID (UUID) da execução.
    - `project_id` string, uuid — Projeto em que o tempo foi contado.
    - `user_id` string, uuid — Pessoa que executou.
    - `funnel_step_id` integer — Etapa do funil em que o tempo foi contado.
    - `started_at` string, date-time — Início da contagem.
    - `finished_at` string, date-time, nullable — Término da contagem. `null` enquanto a execução está em andamento.
    - `hourly_rate` number, nullable — Valor hora aplicado. Só aparece para quem tem acesso a custos.
    - `finished_reason` string, nullable — Motivo do encerramento: `self_stop`, `scheduled_stop`, `step_moved`, `project_deleted`, `project_template` ou `step_deleted`.
    - `started_at_real` string, date-time, nullable — Início original, quando o horário foi ajustado depois.
    - `finished_at_real` string, date-time, nullable — Término original, quando o horário foi ajustado depois.
    - `project` object, nullable — Projeto da execução.
    - `user` object, nullable — Pessoa que executou.
    - `funnel_step` object, nullable — Etapa e funil da execução.
  - `response` boolean, required — Sempre true quando a operação é concluída.

## Other responses

- `422` — Validação falhou

## Changes

- **2026-08-24** `3c590152d5b5` — 11 breaking, 13 warning, 6 info
  - the `finished_at` request property type changed from no type to `string`, and format from no format to `date-time`
  - the `started_at` request property type changed from no type to `string`, and format from no format to `date-time`
  - the response property `data/finished_at` became nullable for the status `200`
  - the response property `data/finished_reason` became nullable for the status `200`
  - …26 more
- **2026-08-19** `3d619d9db20d` — 5 info
  - api tag `Execuções` added
  - api tag `project-execution` removed
  - api tag `{id}` removed
  - added the media type `application/json` for the response with the status `200`
  - …1 more
- **2026-08-19** `d270bef5be29` — 1 info
  - added optional request body

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/projects/:project_id/project-executions/:project_execution_id/put.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/8c9bac94e5ad/schema)