Skip to main content

decideOrgAiSuggestion

Requires permission biddesk:bid:read.

Accepts an organisation-level AI suggestion as is (ACCEPT) or edited (EDIT), writing it through the skill's own applier, or rejects it with a reason (REJECT; OTHER needs a note). Every decision needs the permission the skill names for reading its suggestions; accepting also needs the permission the suggestion's kind names. Refused with ALREADY_DECIDED, NOT_APPLICABLE, INVALID_PAYLOAD, a missing reason or note, and VERSION_CONFLICT when someone decided first. Requires Bid Desk and permission to read 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 DecideOrgAiSuggestion($input: DecideOrgAiSuggestionInput!) {
  decideOrgAiSuggestion(input: $input) {
    id
    status
    createdAt
    appliedRefId
    appliedRefType
    citations
  }
}

Variables:

{
  "input": {
    "decision": "string",
    "expectedVersion": 0,
    "id": "id"
  }
}

Response:

{
  "data": {
    "decideOrgAiSuggestion": {
      "id": "id",
      "status": "ACCEPTED",
      "createdAt": "2025-01-15T00:00:00Z",
      "appliedRefId": "id",
      "appliedRefType": "string",
      "citations": {}
    }
  }
}
decideOrgAiSuggestion(
  input: DecideOrgAiSuggestionInput!
): BidAiOrgSuggestion!

Arguments​

decideOrgAiSuggestion.input ● DecideOrgAiSuggestionInput! non-null input​

The suggestion, its version and the decision.

Type​

BidAiOrgSuggestion object​

A change a Bid Desk AI run suggests for the organisation rather than a bid (an onboarding import, an induced model). Nothing is written until a person accepts it.