Repeated context gathering slows case work. Use the FIOS API to send relevant information from your application to supported agents and return analysis for human review.
The FIOS API allows you to send questions, data and context from your applications and systems, and receive structured, explainable responses from FIOS agents.
POST /customer/api/agents/{agentId}/chat
Content-Type: application/json
X-API-Key: <your-server-side-api-key>
{
"messages": [
{
"role": "user",
"content": "Analyse this transaction context..."
}
],
"response_mode": "standard"
}// Illustrative response; fields depend on the enabled agent.
{
"answer": "The transaction requires further review.",
"sources": [],
"review_required": true
}curl --request POST \
"${FIOS_API_BASE_URL}/customer/api/agents/AGENT_ID/chat" \
--header "X-API-Key: $FIOS_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"messages":[{"role":"user","content":"Analyse this transaction context..."}],"response_mode":"standard"}' import os
import requests
response = requests.post(
os.environ["FIOS_API_BASE_URL"].rstrip("/") + "/customer/api/agents/AGENT_ID/chat",
headers={"X-API-Key": os.environ["FIOS_API_KEY"]},
json={"messages": [{"role": "user", "content": "Analyse this transaction context..."}],
"response_mode": "standard"},
timeout=30,
)
response.raise_for_status()
print(response.json())// Run on your server.
const response = await fetch(
`${process.env.FIOS_API_BASE_URL}/customer/api/agents/AGENT_ID/chat`,
{
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": process.env.FIOS_API_KEY,
},
body: JSON.stringify({
messages: [{role: "user", content: "Analyse this transaction context..."}],
response_mode: "standard",
}),
},
);
if (!response.ok) throw new Error(`FIOS request failed: ${response.status}`);
console.log(await response.json());A simple, secure integration model for enterprise environments.
Access the full API documentation, test the endpoints in your customer portal,
or speak to our team about your integration requirements.
Check the customer portal for the webhook events and delivery options available to your account and enabled agents.
View integration documentation →Keep API keys on your server, send only the context required for the workflow, and preserve source references for human review.
Trust & Governance →