Answer the agent's question (request_human)
When the agent asks a question, the run pauses: the session’s status
becomes awaiting_human and its events include a hitl_requested
event whose data.correlation_id identifies the question
(data.question, and data.options when the agent offered
answer labels). Post the answer here; the run resumes with your text
as the reply. A question stays answerable until the session ends or
a newer message supersedes it.
Only plain questions can be answered here. A request for a secret
(a hitl_requested event whose data.kind is credential or
2fa) is answered only in the Lusor dashboard: any reply to it
made with an API key returns 403 secure_ask_dashboard_only and
stores nothing.
A run created with an API key never reaches that state: when the
agent asks for a secret, the run ends as failed with error
secret_required:<name> (see SessionV2.error) instead of
pausing, so there is nothing to answer. Save the secret in the
workspace, then retry the run naming it in secrets.
Retrying with the same text is idempotent (idempotent: true). A
different answer to a question that was already answered returns
409; the first answer stands.
Workspace scope: workspaceId in the body, otherwise the workspace
bound to the API key.
curl --request POST \
--url https://api.lusor.ai/v1/sessions/{id}/hitl \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"correlation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"response": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
correlation_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
response: '<string>',
workspaceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://api.lusor.ai/v1/sessions/{id}/hitl', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lusor.ai/v1/sessions/{id}/hitl"
payload = {
"correlation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"response": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"resolved": true,
"idempotent": true,
"continuation": {
"status": "queued",
"invocationId": "<string>",
"queued": true
}
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "device_busy",
"currentSessionId": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Authorizations
Workspace API key, created in the dashboard under Settings → API Keys.
Path Parameters
Session ID.
Body
Response
Answer accepted; the run resumes
Show child attributes
Show child attributes
Was this page helpful?
curl --request POST \
--url https://api.lusor.ai/v1/sessions/{id}/hitl \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"correlation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"response": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
correlation_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
response: '<string>',
workspaceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://api.lusor.ai/v1/sessions/{id}/hitl', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lusor.ai/v1/sessions/{id}/hitl"
payload = {
"correlation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"response": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"resolved": true,
"idempotent": true,
"continuation": {
"status": "queued",
"invocationId": "<string>",
"queued": true
}
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "device_busy",
"currentSessionId": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}