POSTAR /api/v1/projects/{id}/executions/{execution_id}/resume

Retoma uma execução suspensa (por exemplo, após a aprovação do ser humano no loop). O escopo do projeto é realizado pelo parâmetro route id path e a organização é derivada desse projeto.

parâmetros de caminho

  • id string Obrigatório

    ID do Projeto

  • execution_id string Obrigatório

    ID de execução

parâmetros de query

  • workspace_id string

    ID do workspace para a resolução do workspace

aplicação/json

corpo, corpo Obrigatório

Retomar carga útil

  • decisão string Obrigatório
  • writeer_notes string
  • suspenso_generação inteiro

    SuspendGeneration fixa a decisão ao snapshot de suspensão que o revisor foi mostrado (a partir do suspenso_generation da execução). O OE rejeita a retomada com um conflito quando a suspensão atual é diferente, de modo que uma aprovação nunca é aplicada para revisar o conteúdo que o revisor nunca viu.

    O valor mínimo é 0.

Respostas

  • Versão de API não permitida ou malformada, uma operação indisponível no contrato publicado selecionado ou uma representação inaceitável (incluindo parâmetros de tipo de mídia não suportados ou SSE excluído). Falhas existentes de autenticação, autorização e limite de taxa têm precedência.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes de validação opcionais definidos pelo esquema de erro padrão; Os erros de negociação da API não emitem este campo.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Campos com falhas de validação.

        Ocultar atributos de campos Mostrar atributos dos campos objeto

        Um campo e sua falha de validação.

        • Descrição string Obrigatório

          Falha na validação legível por humanos.

        • Campo string Obrigatório

          Nome ou caminho do campo de solicitação inválido .

    • detalhe string Obrigatório

      Detalhes de erro legíveis por humanos.

    • Erro inteiro Obrigatório

      HTTP status code.

    • Código de erro string Obrigatório

      Código de erro legível por máquina.

    • Parâmetros array[string]

      Solicitar nomes de parâmetros associados ao erro; omitido quando nenhum se aplica.

    • Razão string Obrigatório

      Frase de razão do status HTTP.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes de validação opcionais definidos pelo esquema de erro padrão; Os erros de negociação da API não emitem este campo.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Campos com falhas de validação.

        Ocultar atributos de campos Mostrar atributos dos campos objeto

        Um campo e sua falha de validação.

        • Descrição string Obrigatório

          Falha na validação legível por humanos.

        • Campo string Obrigatório

          Nome ou caminho do campo de solicitação inválido .

    • detalhe string Obrigatório

      Detalhes de erro legíveis por humanos.

    • Erro inteiro Obrigatório

      HTTP status code.

    • Código de erro string Obrigatório

      Código de erro legível por máquina.

    • Parâmetros array[string]

      Solicitar nomes de parâmetros associados ao erro; omitido quando nenhum se aplica.

    • Razão string Obrigatório

      Frase de razão do status HTTP.

  • 200

    OK

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • Erro string
    • execution_id string
    • Status string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • Erro string
    • execution_id string
    • Status string
    • Sucesso booleano
  • Solicitação inválida

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • Não autorizado

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • Não encontrado

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • 409

    Conflito

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • blocking_execution_id string
    • blocking_status string
    • código string
    • Erro string
    • last_atividade_at string
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • blocking_execution_id string
    • blocking_status string
    • código string
    • Erro string
    • last_atividade_at string
  • 422

    PROJECT_SECRET_INVALID: o espaço de trabalho não pode ser iniciado porque um segredo de projeto é inválido ou inacessível (corrija o segredo e redistribua)

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • 500

    ResumeExecutionResponse, StartupFailureResponse para uma falha de inicialização do AGENT_STARTUP_FAILED/STARTUP_FAILED ou ErrorResponse para uma falha de ativação da ramificação de fluxo de trabalho

    Qualquer um dos seguintes:
    Qualquer um dos seguintes:
  • 502

    Gateway incorreto

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • Erro string
    • execution_id string
    • Status string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • Erro string
    • execution_id string
    • Status string
    • Sucesso booleano
  • 503

    StartupFailureResponse para uma falha de inicialização POOL_EXHAUSTED/EXECUTOR_BOOT_FAILED/PLATFORM_DEPENDENCY_FAILED/POOL_UNREACHABLE; ErrorResponse de outra forma. POOL_EXHAUSTED carrega um cabeçalho Retry-After

    Ocultar atributo de cabeçalhos Mostrar atributo de cabeçalhos
    • Tentar novamente depois string

      Segundos para aguardar antes de tentar novamente (somente POOL_EXHAUSTED)

    Qualquer um dos seguintes:
    Qualquer um dos seguintes:
  • Tempo limite do gateway

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
POST /api/v1/projects/{id}/executions/{execution_id}/resume
curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/executions/{execution_id}/resume' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "decision": "approved",
  "reviewer_notes": "Reviewed and approved.",
  "suspend_generation": 1
}'
Exemplos de solicitação
{
  "decision": "approved",
  "reviewer_notes": "Reviewed and approved.",
  "suspend_generation": 1
}
Exemplos de resposta (406)
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
Exemplos de resposta (406)
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
Exemplos de resposta (200)
{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}
Exemplos de resposta (200)
{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}
Exemplos de resposta (400)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (400)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (401)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (401)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (404)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (404)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (409)
{
  "blocking_execution_id": "string",
  "blocking_status": "string",
  "code": "string",
  "error": "string",
  "last_activity_at": "string"
}
Exemplos de resposta (409)
{
  "blocking_execution_id": "string",
  "blocking_status": "string",
  "code": "string",
  "error": "string",
  "last_activity_at": "string"
}
Exemplos de resposta (422)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (422)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (500)
{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}
{
  "boot_id": "string",
  "code": "string",
  "component": "string",
  "error": "string",
  "execution_id": "string",
  "sandbox": "string",
  "source": "string",
  "success": true
}
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (500)
{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}
{
  "boot_id": "string",
  "code": "string",
  "component": "string",
  "error": "string",
  "execution_id": "string",
  "sandbox": "string",
  "source": "string",
  "success": true
}
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (502)
{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}
Exemplos de resposta (502)
{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}
Exemplos de resposta (503)
# Headers
Retry-After: string

# Payload
{
  "boot_id": "string",
  "code": "string",
  "component": "string",
  "error": "string",
  "execution_id": "string",
  "sandbox": "string",
  "source": "string",
  "success": true
}
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (503)
# Headers
Retry-After: string

# Payload
{
  "boot_id": "string",
  "code": "string",
  "component": "string",
  "error": "string",
  "execution_id": "string",
  "sandbox": "string",
  "source": "string",
  "success": true
}
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (504)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (504)
{
  "code": "string",
  "error": "string",
  "success": true
}