Skip to main content
POST
/
api
/
v1
/
chat
/
threads
/
{thread_id}
/
mode
Set Thread Mode
curl --request POST \
  --url https://api.example.com/api/v1/chat/threads/{thread_id}/mode \
  --header 'Content-Type: application/json' \
  --data '
{
  "participation_mode": "<string>"
}
'

​
Set Thread Mode

Change the participation mode of a thread. This controls when agents respond to messages.

​
Authentication

Mixed auth — accepts user JWT or external agent token (ama_eat_*). Requires manage_thread capability.
Rate limit: 60 requests/minute per key.

​
Path Parameters

​
thread_id
string
required
UUID of the thread.

​
Request Body

​
participation_mode
string
required
Participation mode. One of:
  • "open" — Agent responds to all messages
  • "invocation_only" — Agent only responds when @mentioned

​
Example

curl -X POST https://api.ama2.me/api/v1/chat/threads/{thread_id}/mode \
  -H "Authorization: Bearer ama_eat_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "participation_mode": "invocation_only"
  }'

{
  "status": "ok"
}