POST /v1/harnesses/preview

POST

/v1/harnesses/preview

• Production API

Request Body ^required

Request to preview harness shape with capabilities applied

object

capabilities

Array<object>

Per-agent capability configuration

Associates a capability with an agent, including optional per-agent configuration. The config field allows the same capability to behave differently per-agent.

object

config

Per-agent configuration for this capability (capability-specific)

ref

required

Reference to the capability ID

string

mcpServers

object

key

additional properties

Session-, agent-, or harness-scoped remote MCP server configuration.

This intentionally mirrors the mcpServers object shape used by common MCP client config files while staying within Everruns’ current remote-HTTP-only support.

object

auth_mode

Authentication mode used when executing tools from this scoped server.

string

Allowed values: none api_key o_auth

headers

Additional HTTP headers sent on MCP requests.

object

key

additional properties

string

oauth_provider_id

Provider id used to resolve a user-scoped bearer token.

string | null

tool_discovery

Whether to discover tool definitions live from this server.

boolean

type

MCP transport type. Only remote HTTP is supported today.

string

Allowed values: http

url

required

URL of the remote MCP server endpoint.

string

parent_harness_id

string | null

Example

harness_01933b5a000070008000000000000602

system_prompt

required

string

Example

You are a research assistant.

Responses

200

Harness preview generated

Preview response showing merged prompt and tools

object

system_prompt

required

string

tools

required

Array<object>

object

500

Internal server error

Standard error response for API endpoints.

object

error

required

Error message describing what went wrong.

string