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

# Consultar uma execução iniciada por um entrypoint

> Consulta uma execução com a chave de API que a iniciou. A resposta traz o status e, em `output`, APENAS os campos que o tenant configurou na whitelist de saída do entrypoint; uma whitelist vazia, o padrão, retorna um objeto vazio. A metadata enviada, o payload de entrada, anexos e evidências nunca são retornados aqui.



## OpenAPI

````yaml GET /workflow-executions/{execution_uuid}
openapi: 3.1.0
info:
  description: Superfície pública da API para clientes autenticados por chave de API.
  title: NL Labs Gateway (Public API)
  version: 0.1.0
servers:
  - url: https://api.nlbs.ai
security: []
tags:
  - description: Busca de entidades canônicas.
    name: entities
  - description: Criação, leitura, grafo e dossiê de análises.
    name: analyses
  - description: Relatório regulatório (COAF/SUSEP).
    name: reports
  - description: Triagem de mídia adversa.
    name: adverse-media
  - description: Versões do manifesto regulatório.
    name: regulatory
  - description: Versões do catálogo de regras do motor de risco.
    name: rules
  - description: Endpoints e eventos de webhook.
    name: webhooks
  - description: >-
      Entrypoints HTTP de workflow: invocar um workflow e consultar sua
      execução.
    name: workflow-endpoints
paths:
  /workflow-executions/{execution_uuid}:
    get:
      tags:
        - workflow-endpoints
      summary: Consultar uma execução iniciada por um entrypoint
      description: >-
        Consulta uma execução com a chave de API que a iniciou. A resposta traz
        o status e, em `output`, APENAS os campos que o tenant configurou na
        whitelist de saída do entrypoint; uma whitelist vazia, o padrão, retorna
        um objeto vazio. A metadata enviada, o payload de entrada, anexos e
        evidências nunca são retornados aqui.
      operationId: read_workflow_execution
      parameters:
        - description: Identificador público da execução.
          in: path
          name: execution_uuid
          required: true
          schema:
            description: Identificador público da execução.
            format: uuid
            title: Execution Uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowExecutionReadResponse'
          description: Successful Response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Chave de API ausente, malformada, expirada ou inválida.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: A chave de API autenticada não tem o escopo necessário.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            Nenhuma execução com esse identificador é legível por essa
            credencial.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    WorkflowExecutionReadResponse:
      additionalProperties: false
      properties:
        case_uuid:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          description: >-
            Identificador público do caso de revisão humana que esta execução
            abriu, ou nulo quando a execução ainda não chegou a um nó de fila.
            Continua preenchido após o caso fechar, para o cliente que registrou
            o valor enquanto o caso estava aberto manter uma referência estável.
          title: Case Uuid
        completed_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: Quando a execução chegou a um estado terminal, se chegou.
          title: Completed At
        created_at:
          description: Quando a execução foi aceita.
          format: date-time
          title: Created At
          type: string
        entrypoint_key:
          description: Entrypoint pelo qual esta execução entrou.
          title: Entrypoint Key
          type: string
        execution_uuid:
          description: Identificador público da execução.
          format: uuid
          title: Execution Uuid
          type: string
        output:
          additionalProperties: true
          description: >-
            A saída da execução, restrita aos campos que o output_whitelist do
            entrypoint declara. Uma whitelist vazia retorna um objeto vazio, o
            padrão de todo entrypoint.
          title: Output
          type: object
        status:
          $ref: '#/components/schemas/WorkflowExecutionStatus'
          description: Estado atual da execução.
      required:
        - execution_uuid
        - entrypoint_key
        - status
        - created_at
      title: WorkflowExecutionReadResponse
      type: object
    ErrorResponse:
      properties:
        detail:
          description: Mensagem de erro pública e estável.
          examples:
            - Resource not found.
          title: Detail
          type: string
      required:
        - detail
      title: ErrorResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    WorkflowExecutionStatus:
      enum:
        - queued
        - running
        - waiting_human
        - succeeded
        - failed
        - cancelled
      title: WorkflowExecutionStatus
      type: string
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object

````