Skip to main content
POST https://api.humalike.com/v1/social-memory/actions/ask
Answer an explicit, natural-language question over a scope. Use ask when you want a direct answer about the people in the conversation (“what is Alice allergic to?”), not the per-turn context that recall returns. This is a billable read over the scope’s conversation; see What a read sees.

​
Authorization

​
Authorization
string
required
Your bearer token: Bearer <token>. See Authentication.

​
Request body

​
scope_id
string
required
Which scope to ask over. 1–255 characters. See Scopes.
​
question
string
required
The natural-language question to answer. Non-empty.
Request
{
  "scope_id": "team-chat-1",
  "question": "what is alice allergic to?"
}

​
Response

​
answer
string
The answer to your question, grounded in the scope’s conversation. Empty ("") when the scope has no stored messages yet.
200 OK
{
  "answer": "Alice has said she cannot touch peanuts."
}

​
Errors

StatusCodeWhen
400VALIDATION_ERRORThe request could not be processed, or question is too large for a single call — shorten and retry.
401UNAUTHORIZEDThe bearer token is missing, invalid, or expired.
402PAYMENT_REQUIREDYour account does not have enough credits to cover this request. You are not charged.
403forbiddenThe token is valid but not allowed here.
422VALIDATION_ERRORThe body is malformed (missing scope_id, empty question, etc.).
502UPSTREAM_ERRORA dependency the request relies on was unavailable. Retry with backoff.
See Errors for the full envelope shape.

​
Example

curl https://api.humalike.com/v1/social-memory/actions/ask \
  -H "Authorization: Bearer $HUMALIKE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "scope_id": "team-chat-1",
    "question": "what is alice allergic to?"
  }'