bidAiRun

Requires permission biddesk:bid:read.

One AI run's trace on a bid the caller may see, else null. 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 BidAiRun($id: ID!) {
  bidAiRun(id: $id) {
    id
    errorCode
    status
    attempts
    bidId
    cachedInputTokens
  }
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "query BidAiRun($id: ID!) {\n  bidAiRun(id: $id) {\n    id\n    errorCode\n    status\n    attempts\n    bidId\n    cachedInputTokens\n  }\n}",
  "variables": {
    "id": "id"
  }
}
EOF

Variables:

{
  "id": "id"
}

Response:

{
  "data": {
    "bidAiRun": {
      "id": "id",
      "errorCode": "string",
      "status": "FAILED",
      "attempts": 0,
      "bidId": "id",
      "cachedInputTokens": 0
    }
  }
}

bidAiRun(
  id: ID!
): BidAiRun

Arguments

bidAiRun.id ● ID! non-null scalar

The run.

Type

BidAiRun object

The trace of one Bid Desk AI run on a bid: skill, prompt version, model, tokens, credits, validation errors and output. The model input is shown only as its size.