proposeBidConfiguratorAnswers
Requires permission biddesk:bid:update.
Reads a bid's requirements (and similar past bids on the same model) in the background and leaves AI suggestions for a person to accept or reject: an answer to a question of a released configuration model, quoting the requirement and its page, and a draft customer question for each question no requirement answers. Accepting an answer maps the requirement to the question; nothing is mapped until accepted. Follow progress with bidAiRuns and read the cards with bidAiSuggestions (skillKey requirements-to-answers). Refused with CONFIG_MODEL_NOT_RELEASED, CONFIGURATION_MODEL_MISMATCH or NOTHING_TO_PROPOSE. 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:
- GraphQL
- cURL
mutation ProposeBidConfiguratorAnswers($bidId: ID!, $modelVersionId: ID!) {
proposeBidConfiguratorAnswers(bidId: $bidId, modelVersionId: $modelVersionId) {
runId
started
}
}
curl -X POST "https://<api-host>/graphql" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data @- <<'EOF'
{
"query": "mutation ProposeBidConfiguratorAnswers($bidId: ID!, $modelVersionId: ID!) {\n proposeBidConfiguratorAnswers(bidId: $bidId, modelVersionId: $modelVersionId) {\n runId\n started\n }\n}",
"variables": {
"bidId": "id",
"modelVersionId": "id"
}
}
EOF
Variables:
{
"bidId": "id",
"modelVersionId": "id"
}
Response:
{
"data": {
"proposeBidConfiguratorAnswers": {
"runId": "id",
"started": true
}
}
}
proposeBidConfiguratorAnswers(
bidId: ID!
modelVersionId: ID!
): BidAiRunStarted!
Arguments
proposeBidConfiguratorAnswers.bidId ● ID! non-null scalar
The bid.
proposeBidConfiguratorAnswers.modelVersionId ● ID! non-null scalar
A released configuration model version.
Type
BidAiRunStarted object
Whether an AI run started, and its id once it has one.