Set or change the growth goal
curl -X POST https://api.xholic.ai/v1/mentor/set-goal \ -H "Authorization: Bearer $XHOLIC_API_KEY" \ -H "Content-Type: application/json" \ -d '{"dryRun":true}'xholic mentor set-goal --dry-run{ "name": "set_growth_goal", "arguments": { "dryRun": true }}const response = await fetch("https://api.xholic.ai/v1/mentor/set-goal", { method: "POST", headers: { Authorization: `Bearer ${process.env.XHOLIC_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "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/mentor/set-goal", { "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/mentor/set-goal", headers={"Authorization": f"Bearer {os.environ['XHOLIC_API_KEY']}"}, json={ "dryRun": True },)print(response.json()["summary"])package main
import ( "fmt" "io" "net/http" "os" "strings")
func main() { body := strings.NewReader(`{"dryRun":true}`) req, _ := http.NewRequest("POST", "https://api.xholic.ai/v1/mentor/set-goal", 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/mentor/set-goal");curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('XHOLIC_API_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => '{"dryRun":true}',]);$result = json_decode(curl_exec($ch), true);echo $result['summary'];require "net/http"require "json"
uri = URI("https://api.xholic.ai/v1/mentor/set-goal")req = Net::HTTP::Post.new(uri, "Content-Type" => "application/json")req["Authorization"] = "Bearer #{ENV.fetch("XHOLIC_API_KEY")}"req.body = '{"dryRun":true}'res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }puts JSON.parse(res.body)["summary"]Start the account’s growth goal after the user agreed to it (one active goal at a time), or change or close the active one (goalId with status DONE or DROPPED, or a new target, length or commitments). followers is the follower count to reach; impressions, replies_received and posts count what happens inside the window; engagement_rate is a percent. Xholic tracks it in every session’s brief and grades it when it closes. It posts nothing. Call it only when the user agreed in this conversation; never on your own initiative.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
The active goal to change or close. Leave out to start a new goal.
Close the active goal: DONE grades it now, DROPPED abandons it.
Required for a new goal.
Required for a new goal: a follower count (18), a total (2000) or a percent (4).
How long it runs (default 7).
When it starts (default now), at most a week ahead.
What the user agreed to do; defaults to the proposal’s.
object
Original posts a day the user agreed to.
Replies a day the user agreed to.
Anything else the user agreed to, in their words.
Why this goal, in the user’s words.
X account to act on, as @handle. Leave it out to use the connection’s default account.
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
{ "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" }}