Thread Queries

# Get single thread by ID
query {
  thread(id: "thread-123") {
    id
    contractName
    status
    steps {
      stepName
      status
    }
  }
}

# Search threads with filters
query {
  threads(
    contractName: "order_fulfillment"
    status: "completed"
    limit: 50
  ) {
    totalCount
    threads {
      id
      status
      startedAt
    }
  }
}

# Find by external reference (specific key)
query {
  threadsByRef(
    refKey: "order_id"
    refValue: "ORD-12345"
  ) {
    totalCount
    threads {
      id
      refs
    }
  }
}

# Find by value only (searches all ref keys)
# Useful when you don't know the ref key name
query {
  threadsByRef(
    refValue: "cus_ABC123"
  ) {
    totalCount
    threads {
      id
      refs
    }
  }
}

# Partial match search (case-insensitive)
query {
  threadsByRef(
    refValue: "ABC"
  ) {
    totalCount
    threads {
      id
      refs
    }
  }
}

# Filter threads by tags
query {
  threads(
    tags: ["production", "v2.1"]
    status: "completed"
    limit: 10
  ) {
    totalCount
    threads {
      id
      label
      tags
      status
      startedAt
    }
  }
}