API Reference›Servicing Plane›AI sessions›Submit an AI output

Submit an AI output

POSThttps://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions/{aiSessionId}/outputsRoadmapBearer token ·CREATE_AI_OUTPUT

Stores a proposed summary, recommendation, or draft with citations to allowed facts and evidence.

Roadmap contract. This operation is published product direction and is not registered by the current servicing runtime. Check API availability before building an integration.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions/$AI_SESSION_ID/outputs \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "next_action_recommendation",
  "content": "Offer the in-policy two-installment promise option.",
  "citations": [
    {
      "fact": "loan.amountPastDue",
      "evidenceId": "evd_FACT_81"
    }
  ],
  "confidence": "high"
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions/${aiSessionId}/outputs`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "type": "next_action_recommendation",
  "content": "Offer the in-policy two-installment promise option.",
  "citations": [
    {
      "fact": "loan.amountPastDue",
      "evidenceId": "evd_FACT_81"
    }
  ],
  "confidence": "high"
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions/{ai_session_id}/outputs",
  headers={"Authorization": f"Bearer {token}", "Idempotency-Key": idempotency_key},
  json={
  "type": "next_action_recommendation",
  "content": "Offer the in-policy two-installment promise option.",
  "citations": [
    {
      "fact": "loan.amountPastDue",
      "evidenceId": "evd_FACT_81"
    }
  ],
  "confidence": "high"
},
)

{
  "outputId": "aio_81",
  "aiSessionId": "ais_CASE_71",
  "status": "produced",
  "reviewRequired": true
}

{
  "type": "https://docs.lendeasy.ai/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "code": "forbidden",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/version_conflict",
  "title": "Version Conflict",
  "status": 409,
  "code": "version_conflict",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/validation_error",
  "title": "Validation Error",
  "status": 422,
  "code": "validation_error",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/rate_limited",
  "title": "Rate Limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

Path & query parameters

Field	Type	Description
aiSessionId required in path	string	Stable opaque aiSession identifier.
Idempotency-Key required in header	string	Stable key for this one logical mutation. Reuse it for retries; reusing it with a different request returns 409.

Body parameters

Field	Type	Description
type required	string
content required	string
citations required	array<object>
fact	string
evidenceId	string
confidence required	string

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions/$AI_SESSION_ID/outputs \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "next_action_recommendation",
  "content": "Offer the in-policy two-installment promise option.",
  "citations": [
    {
      "fact": "loan.amountPastDue",
      "evidenceId": "evd_FACT_81"
    }
  ],
  "confidence": "high"
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions/${aiSessionId}/outputs`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "type": "next_action_recommendation",
  "content": "Offer the in-policy two-installment promise option.",
  "citations": [
    {
      "fact": "loan.amountPastDue",
      "evidenceId": "evd_FACT_81"
    }
  ],
  "confidence": "high"
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions/{ai_session_id}/outputs",
  headers={"Authorization": f"Bearer {token}", "Idempotency-Key": idempotency_key},
  json={
  "type": "next_action_recommendation",
  "content": "Offer the in-policy two-installment promise option.",
  "citations": [
    {
      "fact": "loan.amountPastDue",
      "evidenceId": "evd_FACT_81"
    }
  ],
  "confidence": "high"
},
)

{
  "outputId": "aio_81",
  "aiSessionId": "ais_CASE_71",
  "status": "produced",
  "reviewRequired": true
}

{
  "type": "https://docs.lendeasy.ai/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "code": "forbidden",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/version_conflict",
  "title": "Version Conflict",
  "status": 409,
  "code": "version_conflict",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/validation_error",
  "title": "Validation Error",
  "status": 422,
  "code": "validation_error",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/rate_limited",
  "title": "Rate Limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}