Forethought

Forethought Triage API

REST API for the Triage agent. POST a ticket subject (text_a) and body (text_b) plus the model_name issued by Forethought, and receive ranked predictions with confidence scores. Use to drive ticket routing, auto-populated ticket fields, language detection, sentiment, or other customer-trained labels.

Forethought Triage API is one of 2 APIs that Forethought publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko and 2 JSON Schema definitions.

Tagged areas include AI, Customer Support, Triage, Classification, and Predictions. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, a JSON-LD context, sample payloads, 1 Naftiko capability spec, and 2 JSON Schemas.

GitHub OpenAPI

Documentation

📖
Documentation
https://support.forethought.ai/hc/en-us/articles/26701042038419-Triage-API-Guide-for-Users

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/forethought/refs/heads/main/openapi/forethought-triage-api-openapi.yml

Examples

📝
Example
https://raw.githubusercontent.com/api-evangelist/forethought/refs/heads/main/examples/triage-predict-example.json

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/forethought/refs/heads/main/json-schema/forethought-triage-prediction-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/forethought/refs/heads/main/json-structure/forethought-triage-prediction-structure.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/forethought/refs/heads/main/json-ld/forethought-context.jsonld
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/forethought/refs/heads/main/capabilities/triage-predictions.yaml

OpenAPI Specification

forethought-triage-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Forethought Triage API
  description: |
    The Forethought Triage API classifies customer-support tickets and predicts
    the most likely category, sub-category, language, sentiment, or other label
    your Triage model is trained on. Forethought's Implementation Engineering
    team trains and deploys the model and issues a bearer token. Submit the
    ticket subject (`text_a`) and body (`text_b`) and the API returns ranked
    predictions with confidence scores.
  version: '2025-11-01'
  contact:
    name: Forethought Support
    url: https://support.forethought.ai

servers:
  - url: https://api.forethought.ai
    description: Production Server

security:
  - BearerAuth: []

tags:
  - name: Predictions
    description: Predict labels for customer-support tickets.

paths:
  /api/predict:
    post:
      summary: Predict Ticket Triage Labels
      description: |
        Submit a ticket subject and body and receive ranked predictions from a
        Forethought Triage model. Each prediction includes a `prediction_value`
        (the label) and `prediction_confidence` (0.0 to 1.0). Use the top
        prediction to route tickets, populate ticket fields, or trigger
        downstream workflows in Zendesk, Salesforce, or other helpdesks.
      operationId: predictTriage
      tags:
        - Predictions
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PredictRequest'
      responses:
        '200':
          description: Predictions returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PredictResponse'
        '401':
          description: Missing or invalid bearer token.
        '404':
          description: Triage model not found.
        '429':
          description: Request rate limit exceeded.

components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Triage API token
  schemas:
    PredictRequest:
      type: object
      required:
        - model_name
        - text_a
      properties:
        model_name:
          type: string
          description: The Triage model identifier provided by Forethought.
        text_a:
          type: string
          description: Ticket subject or short title.
        text_b:
          type: string
          description: Ticket body or extended description.
    PredictResponse:
      type: object
      properties:
        model_name:
          type: string
        prediction_confidence:
          type: number
          format: float
          minimum: 0
          maximum: 1
        top_predictions:
          type: array
          items:
            $ref: '#/components/schemas/Prediction'
    Prediction:
      type: object
      properties:
        prediction_value:
          type: string
          description: The predicted label.
        prediction_confidence:
          type: number
          format: float
          minimum: 0
          maximum: 1