API Reference›Servicing Plane›AI sessions›Create an AI work session

Create an AI work session

POSThttps://sandbox.api.lendeasy.ai/v1/servicing/ai-sessionsRoadmapBearer token ·CREATE_AI_SESSION

Starts a bounded session from a signed work packet with allowed facts, tools, budgets, and prohibited actions.

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 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "caseId": "case_HBR_COL_51",
  "agentProfile": "collections_assistant",
  "objective": "Summarize the case and recommend the next compliant step.",
  "autonomyLevel": "A2"
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "caseId": "case_HBR_COL_51",
  "agentProfile": "collections_assistant",
  "objective": "Summarize the case and recommend the next compliant step.",
  "autonomyLevel": "A2"
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions",
  headers={"Authorization": f"Bearer {token}", "Idempotency-Key": idempotency_key},
  json={
  "caseId": "case_HBR_COL_51",
  "agentProfile": "collections_assistant",
  "objective": "Summarize the case and recommend the next compliant step.",
  "autonomyLevel": "A2"
},
)

{
  "aiSessionId": "ais_CASE_71",
  "caseId": "case_HBR_COL_51",
  "agentProfile": "collections_assistant",
  "autonomyLevel": "A2",
  "status": "active",
  "workPacketVersion": "wp_2027-04-1",
  "expiresAt": "2027-05-01T10: 45: 00-07: 00"
}

{
  "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
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
caseId required	string	Stable opaque servicing case identifier.
agentProfile required	string
objective required	string
autonomyLevel required	string

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "caseId": "case_HBR_COL_51",
  "agentProfile": "collections_assistant",
  "objective": "Summarize the case and recommend the next compliant step.",
  "autonomyLevel": "A2"
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "caseId": "case_HBR_COL_51",
  "agentProfile": "collections_assistant",
  "objective": "Summarize the case and recommend the next compliant step.",
  "autonomyLevel": "A2"
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/ai-sessions",
  headers={"Authorization": f"Bearer {token}", "Idempotency-Key": idempotency_key},
  json={
  "caseId": "case_HBR_COL_51",
  "agentProfile": "collections_assistant",
  "objective": "Summarize the case and recommend the next compliant step.",
  "autonomyLevel": "A2"
},
)

{
  "aiSessionId": "ais_CASE_71",
  "caseId": "case_HBR_COL_51",
  "agentProfile": "collections_assistant",
  "autonomyLevel": "A2",
  "status": "active",
  "workPacketVersion": "wp_2027-04-1",
  "expiresAt": "2027-05-01T10: 45: 00-07: 00"
}

{
  "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"
}