---
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
  - `funnel_step_id` unknown

## Response `201`

Sucesso

- object
  - `data` object
    - `id` string
    - `project_id` string
    - `user_id` string
    - `funnel_step_id` integer
    - `started_at` string, date-time
    - `finished_at` unknown
    - `hourly_rate` integer
    - `finished_reason` unknown
    - `started_at_real` unknown
    - `finished_at_real` unknown
    - `project` object
      - `id` string
      - `code` string
      - `name` string
      - `is_template` boolean
      - `deleted_at` unknown
    - `user` object
      - `id` string
      - `name` string
      - `avatar_url` unknown
    - `funnel_step` object
      - `id` integer
      - `name` string
      - `project_funnel_id` integer
      - `funnel` object
        - `id` integer
        - `name` string
  - `response` boolean

## Other responses

- `422` — Etapa não permite execução

---

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