Change a plan slot
curl -X POST https://api.xholic.ai/v1/plan/update-slot \ -H "Authorization: Bearer $XHOLIC_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slotId":"<slotId>","dryRun":true}'xholic plan update-slot --slot-id '<slotId>' --dry-run{ "name": "update_plan_slot", "arguments": { "slotId": "<slotId>", "dryRun": true }}const response = await fetch("https://api.xholic.ai/v1/plan/update-slot", { method: "POST", headers: { Authorization: `Bearer ${process.env.XHOLIC_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "slotId": "<slotId>", "dryRun": true }),});const result = await response.json();console.log(result.summary);import axios from "axios";
const { data } = await axios.post( "https://api.xholic.ai/v1/plan/update-slot", { "slotId": "<slotId>", "dryRun": true }, { headers: { Authorization: `Bearer ${process.env.XHOLIC_API_KEY}` } },);console.log(data.summary);import osimport requests
response = requests.post( "https://api.xholic.ai/v1/plan/update-slot", headers={"Authorization": f"Bearer {os.environ['XHOLIC_API_KEY']}"}, json={ "slotId": "<slotId>", "dryRun": True },)print(response.json()["summary"])package main
import ( "fmt" "io" "net/http" "os" "strings")
func main() { body := strings.NewReader(`{"slotId":"<slotId>","dryRun":true}`) req, _ := http.NewRequest("POST", "https://api.xholic.ai/v1/plan/update-slot", body) req.Header.Set("Authorization", "Bearer "+os.Getenv("XHOLIC_API_KEY")) req.Header.Set("Content-Type", "application/json") res, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() out, _ := io.ReadAll(res.Body) fmt.Println(string(out))}<?php$ch = curl_init("https://api.xholic.ai/v1/plan/update-slot");curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('XHOLIC_API_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => '{"slotId":"<slotId>","dryRun":true}',]);$result = json_decode(curl_exec($ch), true);echo $result['summary'];require "net/http"require "json"
uri = URI("https://api.xholic.ai/v1/plan/update-slot")req = Net::HTTP::Post.new(uri, "Content-Type" => "application/json")req["Authorization"] = "Bearer #{ENV.fetch("XHOLIC_API_KEY")}"req.body = '{"slotId":"<slotId>","dryRun":true}'res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }puts JSON.parse(res.body)["summary"]Change one slot of this week’s plan: swap its sub-topic (an approved sub-topic id), mechanism, format or time (day and localTime in the account’s timezone), save its text (a post you wrote in the user’s voice for it, with sourcePostId: the proven post from search_inspiration whose shape it borrows), or skip it. Changing the idea clears text that no longer fits, resets where the idea came from, and takes the slot out of the week’s test when it no longer fits it. Text is checked against the user’s own rules; a draft that breaks one or has a detail Xholic can’t back is marked needs_look. It schedules nothing. Approved slots can’t change here (edit the queued post instead).
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
The slot’s id from get_week_plan (e.g. s-20261124-0930).
An approved sub-topic id.
Why people would respond: confession_question, forced_choice, fresh_finding, sharp_distinction, honest_moment, before_after, open_question, practical_list, bold_claim or relatable_humor.
The post’s shape, such as question, personal_story or list_playbook.
New local date, YYYY-MM-DD.
New local time, HH:MM.
The post’s text, in the user’s voice.
The proven post (an X post id from search_inspiration) whose shape the text borrows. Its words are never copied.
Skip this slot this week (false brings it back).
X account to act on, as @handle. Leave it out to use the connection’s default account.
Optional, on any tool: one or two sentences for Xholic’s shared memory about what the user just decided, asked for or said about themselves or their plans (e.g. “Dropping threads for now; focusing on replies to founders”). Every AI the user connects reads it, so they never repeat themselves. In your words, never other people’s posts. Leave it out when nothing new was said.
Return exactly what would happen without doing it.
A unique key for this write. Repeating a call with the same key returns the first result instead of acting twice.
Example
{ "slotId": "<slotId>", "dryRun": true}Responses
Section titled “Responses”Success
object
One or two readable sentences about the result.
The result. Its shape depends on the action.
object
Example
{ "ok": true}default
Section titled “default”Error
object
object
Example
{ "ok": false, "error": { "code": "UNAUTHENTICATED", "scope": "account" }}