Customer Flow Edge Case

Update an edge case

Changed on

Updates an edge case's title, persona, environment, brief, preceded-by link or expectations. Omitted fields are left alone; additionalExpectations replaces the set wholesale rather than appending. Promoting it to the happy path is a separate call, since that also demotes the incumbent.

put/v1/customer-flow/{flowId}/edge-case/{edgeCaseId}

Request

  • Base URL
    https://api.roark.ai
  • URL
    https://api.roark.ai/v1/customer-flow/{flowId}/edge-case/{edgeCaseId}
  • Auth
    HTTP bearer

Path parameters

flowIdstring uuid required
edgeCaseIdstring uuid required

Request body

titlestring
environmentIdstring uuid nullable
promptstring nullable
precededByCustomerFlowIdstring uuid nullable
precededByCustomerFlowVariantIdstring uuid nullable
includeFlowExpectationsboolean

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.

personaOverrideIdstring uuid nullable

The persona this runs as. Null on an edge case inherits the happy path's.

Example request

{
  "additionalExpectations": [
    {
      "prompt": "The agent confirmed the new appointment time back to the customer"
    }
  ]
}

Response

The updated edge case

Example response

{
  "data": {
    "personaOverride": {
      "backstoryPrompt": "A busy professional calling during lunch break",
      "properties": {
        "age": 35,
        "zipCode": "94105",
        "occupation": "Software Engineer"
      },
      "phoneNumber": "+19312830919"
    }
  }
}

Changes

    • info

      added the new optional request property

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status