bidChaseDraft

Requires permission biddesk:bid:read.

The outside reminder a price request or customer question is due for now, ready to send; null once it is answered or closed, while nothing is due, or when that reminder already went. 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 BidChaseDraft($subjectId: ID!, $subjectKind: BidProactiveSubjectKind!) {
  bidChaseDraft(subjectId: $subjectId, subjectKind: $subjectKind) {
    audience
    bidId
    bodyText
    dueAt
    mode
    slotKey
    recipients {
      address
      deliverable
    }
  }
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "query BidChaseDraft($subjectId: ID!, $subjectKind: BidProactiveSubjectKind!) {\n  bidChaseDraft(subjectId: $subjectId, subjectKind: $subjectKind) {\n    audience\n    bidId\n    bodyText\n    dueAt\n    mode\n    slotKey\n    recipients {\n      address\n      deliverable\n    }\n  }\n}",
  "variables": {
    "subjectId": "id",
    "subjectKind": "APPROVAL_STAGE"
  }
}
EOF

Variables:

{
  "subjectId": "id",
  "subjectKind": "APPROVAL_STAGE"
}

Response:

{
  "data": {
    "bidChaseDraft": {
      "audience": "CUSTOMER",
      "bidId": "id",
      "bodyText": "string",
      "dueAt": "2025-01-15T00:00:00Z",
      "mode": "AUTO",
      "slotKey": "id",
      "recipients": [
        {
          "address": "string",
          "deliverable": true
        }
      ]
    }
  }
}

bidChaseDraft(
  subjectId: ID!
  subjectKind: BidProactiveSubjectKind!
): BidChaseDraft

Arguments

bidChaseDraft.subjectId ● ID! non-null scalar

The waiting item.

bidChaseDraft.subjectKind ● BidProactiveSubjectKind! non-null enum

VENDOR_REQUEST or CUSTOMER_CLARIFICATION.

Type

BidChaseDraft object

An outside reminder ready to send: from a fixed template, with the organization's own paragraph if it wrote one. Carries no amount.