Properties
| Name | Type | Description |
|---|---|---|
| title | string | |
| environmentId | stringnull | |
| prompt | stringnull | |
| precededByCustomerFlowId | stringnull | |
| precededByCustomerFlowVariantId | stringnull | |
| includeFlowExpectations | boolean | Whether this edge case is graded on the flow's agentExpectations as well as its own additionalExpectations. Defaults to true; false grades it on its additionalExpectations only. |
| additionalExpectations | array | The expectations graded on this variant only, on top of the flow's own. Sent as the complete set: it replaces whatever the variant had, so omit it to leave the set alone and send [] to clear it. Impro |
| personaOverrideId | stringnull | The persona this runs as. Omit to inherit the happy path's. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/roark/json-schema/roark-add-flow-edge-case-input-schema.json",
"title": "AddFlowEdgeCaseInput",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/roark-customer-flow-edge-case-api-openapi.yml#/components/schemas/AddFlowEdgeCaseInput",
"$ref": "#/$defs/FlowEdgeCaseInput",
"$defs": {
"FlowEdgeCaseInput": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1
},
"environmentId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"prompt": {
"type": [
"string",
"null"
]
},
"precededByCustomerFlowId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"precededByCustomerFlowVariantId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"includeFlowExpectations": {
"type": "boolean",
"description": "Whether this edge case is graded on the flow's agentExpectations as well as its own additionalExpectations. Defaults to true; false grades it on its additionalExpectations only."
},
"additionalExpectations": {
"type": "array",
"items": {
"$ref": "#/$defs/FlowExpectationInput"
},
"description": "The expectations graded on this variant only, on top of the flow's own. Sent as the complete set: it replaces whatever the variant had, so omit it to leave the set alone and send [] to clear it. Improv flows only: a scripted variant's expectations come from the agent turns on its path and are rewritten on every graph edit."
},
"personaOverrideId": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "The persona this runs as. Omit to inherit the happy path's."
}
},
"required": [
"title"
]
},
"FlowExpectationInput": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"minLength": 1,
"description": "What the agent under test is graded against."
}
},
"required": [
"prompt"
]
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/roark-add-flow-edge-case-input"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.