Probably
Docs

Message Looky

send_message, in Changes: A connection or key that may make changes. None spends credits; prepare_* and stage tools (research, brainstorm, write_script, review, generate_clip, voice, storyboard) prepare paid work for confirm_spend.

POST
/api/v1/tools/send_message

Send a message to Looky in a video's conversation, or to a crew member by addressedTo, on its main line or the variant line names. While the video is being made it steers the run, as the studio's Send does. The reply arrives in get_video and wait_for_video. A note that would remake paid work comes back as a change waiting on you; paid work itself is started with the prepare_* tools and confirm_spend. Pass a new requestKey for each message; repeating one sends it once.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key (prb_…) from Settings → Connections.

Request Body

application/json
  1. body
videoId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
line?string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
text*string
Length1 <= length <= 4000
addressedTo?string
Value in"planner""researcher""writer""producer""editor"
requestKey*string
Match^[\w.:-]+$
Length8 <= length <= 64

Response Body

The tool's answer.

application/json
  1. response
messageId*string
curl -X POST 'https://studio.probably.co/api/v1/tools/send_message' \  -H "Authorization: Bearer $PROBABLY_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "videoId": "3524e86f-1bba-489a-bf6b-386ea1abbac0",  "text": "string",  "requestKey": "stringst"}'
{  "messageId": "string"}