bidNextActions

Requires permission biddesk:bid:read.

The next actions of up to 100 bids the caller may see, ranked within each bid, for the holders of the waiting items. Unknown or invisible bids are left out. 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:

GraphQL

query BidNextActions($bidIds: [ID!]!) {
  bidNextActions(bidIds: $bidIds) {
    bidNumber
    bidId
    bidTitle
    blockers
    key
    kind
    target {
      type
      anchorId
      anchorType
      bidId
      handoffId
      handoffVersion
    }
  }
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "query BidNextActions($bidIds: [ID!]!) {\n  bidNextActions(bidIds: $bidIds) {\n    bidNumber\n    bidId\n    bidTitle\n    blockers\n    key\n    kind\n    target {\n      type\n      anchorId\n      anchorType\n      bidId\n      handoffId\n      handoffVersion\n    }\n  }\n}",
  "variables": {
    "bidIds": [
      "id"
    ]
  }
}
EOF

Variables:

{
  "bidIds": [
    "id"
  ]
}

Response:

{
  "data": {
    "bidNextActions": [
      {
        "bidNumber": "string",
        "bidId": "id",
        "bidTitle": "string",
        "blockers": 0,
        "key": "string",
        "kind": "ACCEPT_HANDOFF",
        "target": {
          "type": "APPROVAL",
          "anchorId": "id",
          "anchorType": "APPROVAL_STAGE",
          "bidId": "id",
          "handoffId": "id",
          "handoffVersion": 0
        }
      }
    ]
  }
}

bidNextActions(
  bidIds: [ID!]!
): [BidNextAction!]!

Arguments

bidNextActions.bidIds ● [ID!]! non-null scalar

The bids, at most 100.

Type

BidNextAction object

One ranked next action on a bid. Counts and minutes only, never an amount.