Skip to main content
POST
/
v1
/
sessions
/
{session_id}
/
message
Send Message
curl --request POST \
  --url https://api.example.com/v1/sessions/{session_id}/message
Send a follow-up message to a running session’s agent. Use this to provide additional instructions, answer questions, or redirect the agent mid-task.

​
Request

curl -X POST https://api.tapkit.ai/v1/sessions/{session_id}/message \
  -H "X-API-Key: joot_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"message": "Actually, like 5 posts instead of 3"}'

​
Path Parameters

ParameterTypeDescription
session_idstringThe session identifier

​
Request Body

{
  "message": "Actually, like 5 posts instead of 3"
}
FieldTypeRequiredDescription
messagestringYesThe message to send to the agent

​
Response

Status: 204 No Content No response body.

​
Examples

​
Python

import requests

requests.post(
    f"https://api.tapkit.ai/v1/sessions/{session_id}/message",
    headers={
        "X-API-Key": "joot_...",
        "Content-Type": "application/json"
    },
    json={"message": "Skip any sponsored posts"}
)