Skip to main content
PATCH
/
api
/
agents
/
{id}
Update evaluation agent
curl --request PATCH \
  --url https://agent-evalserver-production.up.railway.app/api/agents/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "Support bot evaluation",
  "seed": 123,
  "numNodes": 100,
  "publicUrl": "https://example.com/chat",
  "advancedPayload": {
    "payload": "{\"message\":\"[eval-question]\"}"
  }
}
'
{
  "id": "2f7e9c9c-9a2e-4e3a-b77f-6d9d1a7e3a11",
  "name": "Support bot evaluation",
  "seed": 123,
  "numNodes": 100,
  "publicUrl": "https://example.com/chat",
  "advancedPayload": {
    "payload": "{\"message\":\"[eval-question]\"}"
  },
  "label": "eval",
  "created_at": "2026-06-02T15:00:00Z",
  "updated_at": "2026-06-02T15:05:00Z"
}

Authorizations

​
x-api-key
string
header
required

Platform API key for authenticated account-level API access

Path Parameters

​
id
string<uuid>
required

Evaluation agent ID returned by Create evaluation agent.

Body

application/json

Update the evaluation agent metadata, endpoint URL, or request payload template.

​
name
string

Updated human-readable name.

Example:

"Support bot evaluation"

​
seed
integer

Updated deterministic seed.

Example:

123

​
numNodes
integer
default:100

Updated evaluation graph size hint. Use 100 for normal integrations.

Example:

100

​
publicUrl
string<uri> | null

Updated public HTTPS endpoint for your agent.

Example:

"https://example.com/chat"

​
advancedPayload
object

Updated request payload template for non-standard agent APIs.

Example:
{
  "payload": "{\"message\":\"[eval-question]\"}"
}

Response

Evaluation agent updated

Evaluation agent registered in Rippletide. This record tells Rippletide what external agent endpoint to test and how to store evaluation results.

​
name
string
required

Human-readable name for this evaluation agent.

Example:

"Support bot evaluation"

​
seed
integer
required

Deterministic seed used by the evaluation setup. Use any integer; the CLI generates one automatically.

Example:

123

​
numNodes
integer
default:100
required

Evaluation graph size hint. Use 100 unless the Rippletide team recommends another value.

Example:

100

​
id
string<uuid>

Unique agent identifier returned by Rippletide. Use this ID in later evaluation API calls.

Example:

"2f7e9c9c-9a2e-4e3a-b77f-6d9d1a7e3a11"

​
publicUrl
string<uri> | null

Public HTTPS endpoint for the agent Rippletide should evaluate.

Example:

"https://example.com/chat"

​
advancedPayload
object

Optional request payload template used when Rippletide calls the agent endpoint. Omit this for standard chat-style APIs.

Example:
{
  "payload": "{\"message\":\"[eval-question]\"}"
}
​
label
enum<string>
default:eval

Public integrations should use eval.

Available options:
eval
Example:

"eval"

​
created_at
string<date-time>

Creation timestamp.

Example:

"2026-06-02T15:00:00Z"

​
updated_at
string<date-time>

Last update timestamp.

Example:

"2026-06-02T15:05:00Z"