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

# Iniciar uma execução

`POST /api/management/projects/{project}/project-executions`

Inicia a contagem de tempo do usuário autenticado no projeto, na etapa informada. Qualquer execução que ele tenha em andamento é encerrada automaticamente antes; se já houver uma execução rodando naquela mesma etapa, ela é devolvida sem que uma nova seja criada.

O projeto precisa estar na etapa indicada, e tanto o funil quanto a etapa precisam permitir execução — veja [Permitir execução](https://docs.olie.ai/guides/funnels/creating-funnels). Tokens de aplicação não podem iniciar execuções.

## Query parameters

- `funnel_step_id` string

## Request body

- object — Etapa em que a execução começa.
  - `funnel_step_id` integer, required — ID da etapa do funil em que o tempo será contado.

## Response `201`

Sucesso

- 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` — Etapa não permite execução

## Changes

- **2026-08-24** `3c590152d5b5` — 12 breaking, 12 warning, 5 info
  - the request property `funnel_step_id` became not nullable
  - the request property `funnel_step_id` became required
  - the `funnel_step_id` request property type changed from no type to `integer`
  - the response property `data/funnel_step` became nullable for the status `201`
  - …25 more
- **2026-08-19** `3d619d9db20d` — 1 breaking, 5 info
  - removed the success response with the status `200`
  - api tag `Execuções` added
  - api tag `project-execution` removed
  - api tag `{id}` removed
  - …2 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/project-executions/post.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)