Bind a signal set to an agent | Runtype Documentation

curl -X POST https://api.runtype.com/v1/signal-bindings \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "signalSetId": "sset_01hx9k2m3n4p5q6r7s8t9u0v",
  "target": {
    "id": "agt_01hx9k2m3n4p5q6r7s8t9u0v",
    "kind": "agent"
  }
}'

{
  "binding": {
    "budget": {
      "monthlyUsd": 25
    },
    "coverage": {},
    "createdAt": "2024-06-15T10:30:00Z",
    "disabledAt": "string",
    "enabled": true,
    "externalProcessingAcknowledgedAt": "string",
    "filter": {},
    "id": "sbnd_01hx9k2m3n4p5q6r7s8t9u0v",
    "signalSetId": "sset_01hx9k2m3n4p5q6r7s8t9u0v",
    "signalSetVersionId": "sver_01hx9k2m3n4p5q6r7s8t9u0v",
    "target": {
      "id": "agt_01hx9k2m3n4p5q6r7s8t9u0v",
      "kind": "agent"
    },
    "uniformShare": 0.05,
    "signalSetName": "Customer Support Quality Signals",
    "versionNumber": 3
  }
}

Evaluate a set version on every matching turn of an agent from now on. Refused for an agent with loggingPolicy “off” and under zero data retention; an organization handling PHI must pass acknowledgeExternalProcessing.

Authentication

AuthorizationBearer

API key or Clerk session token

Request

This endpoint expects an object.

signalSetIdstringRequired

targetobjectRequired

Native and external (OTLP) agents bind alike.

acknowledgeExternalProcessingbooleanOptional

Required for a PHI organization whose set uses a decision model outside Cloudflare Workers AI. Written to the audit log.

budgetobjectOptional

Default $25 a month.

coverageobjectOptional

filterobjectOptional

uniformSharedoubleOptional0-1

Share drawn uniformly at random BEFORE the filter, so live-traffic rates stay unbiased. Default 0.05.

versionNumberintegerOptional>=1

Defaults to the set’s current version.

Response

Bound

bindingobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error