bidThreads

Requires permission biddesk:bid:read.

Lists a bid's threads, most recently active first, optionally about one kind of item, one item or one status. Only the bid's members can use its room. 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 BidThreads($input: BidThreadsInput!) {
  bidThreads(input: $input) {
    nextCursor
    items {
      id
      status
      createdAt
      anchorId
      anchorType
      bidId
    }
  }
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "query BidThreads($input: BidThreadsInput!) {\n  bidThreads(input: $input) {\n    nextCursor\n    items {\n      id\n      status\n      createdAt\n      anchorId\n      anchorType\n      bidId\n    }\n  }\n}",
  "variables": {
    "input": {
      "bidId": "id"
    }
  }
}
EOF

Variables:

{
  "input": {
    "bidId": "id"
  }
}

Response:

{
  "data": {
    "bidThreads": {
      "nextCursor": "string",
      "items": [
        {
          "id": "id",
          "status": "OPEN",
          "createdAt": "2025-01-15T00:00:00Z",
          "anchorId": "id",
          "anchorType": "APPROVAL_STAGE",
          "bidId": "id"
        }
      ]
    }
  }
}

bidThreads(
  input: BidThreadsInput!
): BidThreadPage!

Arguments

bidThreads.input ● BidThreadsInput! non-null input

The bid and the filters.

Type

BidThreadPage object

A page of a bid's threads, most recently active first.