Promova uma construção neste espaço de trabalho

POSTAR /api/v1/projects/{id}/workspaces/{workspace_id}/promoções
Autenticação do portador

Copia a imagem de uma compilação bem-sucedida existente de outro workspace na mesma organização para este workspace e cria uma compilação implementável. Requer gerenciamento de implantação no projeto de compilação de origem e no projeto de destino ; force requer adicionalmente a função de proprietário do projeto de destino. O processamento é assíncrono — pesquise a promoção retornada até que esteja pronta ou com falha.

parâmetros de caminho

  • id string Obrigatório

    ID do projeto de destino

  • workspace_id string Obrigatório

    ID do espaço de trabalho de destino

aplicação/json

corpo, corpo Obrigatório

Solicitação de promoção

  • confirmado booleano Obrigatório

    Confirmado deve ser verdadeiro: a promoção copia um artefato para outro projeto, portanto, a API exige a confirmação explícita que a CLI/UI coleta do usuário.

  • força booleano

    A força ignora o portal à prova de implantação do ECP; requer a função de proprietário do projeto de destino.

  • source_build_id string Obrigatório

    SourceBuildID identifica a compilação bem-sucedida a ser promovido. Ele pode estar em qualquer projeto da organização do chamador.

Respostas

  • 406

    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.
  • 202

    Aceito

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • created_at string
    • failure_reason string
    • completed_at string
    • força booleano
    • initial_by string
    • org_id string
    • introduction_id string
    • source_build_id string
    • Status string

      O status é pendente, copiando, pronto ou com falha. Aprovado e reprovado são resultados terminais; pending e copying são os estados de sondagem não terminais observáveis.

      Os valores são pending, copying, ready ou failed.

    • target_build_id string
    • target_project_id string
    • target_workspace_id string
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • created_at string
    • failure_reason string
    • completed_at string
    • força booleano
    • initial_by string
    • org_id string
    • introduction_id string
    • source_build_id string
    • Status string

      O status é pendente, copiando, pronto ou com falha. Aprovado e reprovado são resultados terminais; pending e copying são os estados de sondagem não terminais observáveis.

      Os valores são pending, copying, ready ou failed.

    • target_build_id string
    • target_project_id string
    • target_workspace_id string
  • 400

    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
  • 403

    Proibido

    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
  • 404

    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
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • 413

    Entidade solicitante muito grande

    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
  • 429

    Muitas solicitações

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

      Segundos para esperar antes de tentar novamente

    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

    Erro interno do servidor

    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
  • 502

    Gateway incorreto

    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
  • 503

    Serviço indisponível

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

      Segundos para esperar antes de tentar novamente após uma exclusão de capacidade

    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}/workspaces/{workspace_id}/promoções 
curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}/promotions' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "confirmed": true,
  "force": true,
  "source_build_id": "string"
}'
Exemplos de solicitação 
{
  "confirmed": true,
  "force": true,
  "source_build_id": "string"
}
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 (202) 
{
  "created_at": "string",
  "failure_reason": "string",
  "finished_at": "string",
  "force": true,
  "initiated_by": "string",
  "org_id": "string",
  "promotion_id": "string",
  "source_build_id": "string",
  "status": "pending",
  "target_build_id": "string",
  "target_project_id": "string",
  "target_workspace_id": "string"
}
Exemplos de resposta (202) 
{
  "created_at": "string",
  "failure_reason": "string",
  "finished_at": "string",
  "force": true,
  "initiated_by": "string",
  "org_id": "string",
  "promotion_id": "string",
  "source_build_id": "string",
  "status": "pending",
  "target_build_id": "string",
  "target_project_id": "string",
  "target_workspace_id": "string"
}
Exemplos de resposta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (403) 
{
  "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) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (409) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (429) 
# Headers
Retry-After: string

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

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

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

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}