Skip to content
X-Buddy
Tiếng Việt

API reference

Run a write operation

execute_write — Run any write operation (kind X, W or D) found with tools_search, with an idempotency_key.

Markdown version

execute_write · Changes an X-Buddy setting

Run any write operation (kind X, W or D) found with tools_search, with an idempotency_key. Permissions, limits and the dispatch gate apply exactly as when calling it directly.
REST POST /api/public/v1/operations/write
MCP tool execute_write
Permission needed accounts.run — Owner, Manager, Operator
Scope group accounts:read
Group Indirect calls and docs
Shown up front in profiles every profile (core set)

Input

Field Type Required Description
id string (0–64 chars) Yes Operation id.
args object No The operation's input fields (without idempotency_key).

Result

Returns the operation's result in the { data, meta } envelope.

Needs an idempotency key (Idempotency-Key, 8–128 characters). Retrying with the same key never repeats the action.

Example

Call over REST

curl -X POST "https://reach-link-craft.lovable.app/api/public/v1/operations/write" \
  -H "Authorization: Bearer $XBUDDY_API_KEY" \
  -H "Idempotency-Key: 6f1c2a90-example-key" \
  -H "Content-Type: application/json" \
  -d '{"id":"00000000-0000-4000-8000-000000000001"}'

Call over MCP

{
  "method": "tools/call",
  "params": {
    "name": "execute_write",
    "arguments": {
      "id": "00000000-0000-4000-8000-000000000001",
      "idempotency_key": "6f1c2a90-example-key"
    }
  }
}

Errors you may get

Code HTTP Retryable
unauthorized 401 No
key_expired 401 No
integration_revoked 401 No
connection_not_linked 403 No
integration_paused 403 No
workspace_integrations_paused 403 No
integration_authorization_lost 403 No
workspace_suspended 403 No
forbidden 403 No
invalid_input 422 No
rate_limited 429 Yes
internal 500 Yes
read_only 403 No
idempotency_key_required 428 No
idempotency_conflict 409 No
idempotency_processing 409 Yes
conflict 409 No
precondition_failed 422 No

Back to all operations