Skip to main content

proposeBidConfigurationChanges

Requires permission biddesk:bid:update.

Reads a draft configuration's bid requirements and the frozen configurations of similar past bids on the same assembly in the background, and leaves AI suggestions for a person to accept or reject: an option choice or a line change (add, replace, re-quantify or remove) that a past bid made for what a requirement of this bid asks, citing both the requirement and the past bid. Nothing changes until a card is accepted; accepting writes through the configuration's own update and change operations, so a change the structure cannot hold is refused. Follow progress with bidAiRuns and read the cards with bidAiSuggestions (skillKey config-draft). Refused with CONFIGURATION_NOT_DRAFT, NOTHING_TO_PROPOSE or NO_SIMILAR_CONFIGURATION. Requires Bid Desk, the engineered plan feature and permission to update bids.

Errors: a failed call returns a GraphQL errors entry, not a field on the result, and data may be null or partial. Read the entry's extensions.code and message; every shape and code is in the Error reference.

Example:

mutation ProposeBidConfigurationChanges($configurationId: ID!) {
  proposeBidConfigurationChanges(configurationId: $configurationId) {
    runId
    started
  }
}

Variables:

{
  "configurationId": "id"
}

Response:

{
  "data": {
    "proposeBidConfigurationChanges": {
      "runId": "id",
      "started": true
    }
  }
}
proposeBidConfigurationChanges(
  configurationId: ID!
): BidAiRunStarted!

Arguments​

proposeBidConfigurationChanges.configurationId ● ID! non-null scalar​

A draft configuration of a bid.

Type​

BidAiRunStarted object​

Whether an AI run started, and its id once it has one.