> ## Documentation Index > Fetch the complete documentation index at: https://docs.olie.ai/llms.txt > Use this file to discover all available pages before exploring further. # Iniciar uma execução > 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. ## OpenAPI ````yaml /api-reference/openapi.json post /api/management/projects/{project}/project-executions openapi: 3.0.0 info: title: Olie API version: 1.0.0 description: > # Introdução 👋 Olá! Esta é a documentação oficial da API da [olie.ai](https://olie.ai/). Aqui você encontra as referências e exemplos de uso dos nossos endpoints. Para uma visão completa, recomendamos fortemente que você leia a [documentação oficial](https://docs.olie.ai/api-reference/introduction). Lá estão detalhados tópicos essenciais como [autenticação](https://docs.olie.ai/api-reference/introduction/authentication), [estrutura de respostas](https://docs.olie.ai/api-reference/general/response-structure), [paginação](https://docs.olie.ai/api-reference/general/pagination) e outros guias de integração. No Postman, esta coleção foca nas informações específicas de cada requisição (endpoints, parâmetros e exemplos), servindo como apoio rápido para testes e desenvolvimento. servers: - url: https://api.olie.ai security: - BearerAuth: [] paths: /api/management/projects/{project}/project-executions: parameters: - name: project in: path required: true description: ID (UUID) do projeto. schema: type: string example: '{{project_id}}' post: tags: - projects - Execuções summary: Iniciar uma execução description: >- 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. parameters: - name: funnel_step_id in: query description: ID da etapa onde será executado o projeto schema: type: string example: string requestBody: content: application/json: schema: type: object properties: funnel_step_id: type: integer description: ID da etapa do funil em que o tempo será contado. description: Etapa em que a execução começa. required: - funnel_step_id example: funnel_step_id: null responses: '201': description: Sucesso content: application/json: schema: description: Execução devolvida sob a chave `data`. type: object properties: data: description: Registro de tempo de trabalho. type: object properties: id: type: string description: ID (UUID) da execução. format: uuid project_id: type: string description: Projeto em que o tempo foi contado. format: uuid user_id: type: string description: Pessoa que executou. format: uuid funnel_step_id: type: integer description: Etapa do funil em que o tempo foi contado. started_at: type: string description: Início da contagem. format: date-time finished_at: type: string description: >- Término da contagem. `null` enquanto a execução está em andamento. format: date-time hourly_rate: type: number description: >- Valor hora aplicado. Só aparece para quem tem acesso a custos. finished_reason: type: string description: >- Motivo do encerramento: `self_stop`, `scheduled_stop`, `step_moved`, `project_deleted`, `project_template` ou `step_deleted`. started_at_real: type: string description: Início original, quando o horário foi ajustado depois. format: date-time finished_at_real: type: string description: >- Término original, quando o horário foi ajustado depois. format: date-time project: type: object description: Projeto da execução. user: type: object description: Pessoa que executou. funnel_step: type: object description: Etapa e funil da execução. response: type: boolean description: Sempre true quando a operação é concluída. required: - data - response example: data: id: a14afcbd-38b1-4b97-8950-02c09547611a project_id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf user_id: 019c1e87-63f4-71dd-a4e3-6eaea0619c2f funnel_step_id: 181 started_at: '2026-08-19T13:05:00.000000Z' finished_at: null hourly_rate: 85 finished_reason: null started_at_real: null finished_at_real: null project: id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf code: SC-1 name: Shopping Center is_template: false deleted_at: null user: id: 019c1e87-63f4-71dd-a4e3-6eaea0619c2f name: Ana Souza avatar_url: null funnel_step: id: 181 name: Execução project_funnel_id: 36 funnel: id: 36 name: Obras response: true '422': description: Etapa não permite execução content: application/json: schema: type: object properties: response: type: boolean description: Sempre false em respostas de erro. message: type: string description: >- Identificador do erro, usado pelo cliente para tratar o caso. error: type: string description: Descrição legível do erro. required: - response - message - error example: response: false message: execution_not_allowed_on_step error: Project executions are not allowed on this funnel/step components: securitySchemes: BearerAuth: type: http scheme: bearer ````