Confirm a mutation

Confirm the same prepared input with both required headers. Additional publishing review and human approval rules still apply. A 200 response can contain ok:false; accepted or scheduled work is not proof of publication. JSON requests are limited to 65,536 bytes.

POST/api/v1/tools/{tool}/confirm

Authorization

AuthorizationBearer token · headerrequired

Influence scoped API key or supported OAuth access token. Keep credentials out of URLs and tool input.

Path parameters

toolstringrequired

Tool name returned by GET /api/v1/tools. Discovery is filtered by this credential's permissions; schema presence does not establish availability.

Header parameters

X-Publish-ConfirmationConfirmationCapabilityrequired

The exact confirmationCapability returned by prepare. Send it only in this header, with the same input, before expiresAt.

min length 32 · max length 4096 · matches ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyrequired

Caller-generated retry identity. Preserve this key, capability and input after an uncertain response.

min length 16 · max length 200 · matches ^[A-Za-z0-9._:-]+$

Request body

requiredapplication/json

inputobjectrequired

Responses

200

Tool result; inspect ok and error.

One of:

object

okbooleanrequired

output__schema0required

Show properties

__schema0

toolNamestringrequired

Allowed:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjectrequired

Show properties

codestringrequired

Allowed:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringrequired

min length 1 · max length 2048

retryablebooleanrequired

okbooleanrequired

toolNamestringrequired

400

Invalid request. Query parameters are not accepted. Tool validation failures may use a tool error envelope.

Any of:

TransportError

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

ToolError

errorobjectrequired

Show properties

codestringrequired

Allowed:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringrequired

min length 1 · max length 2048

retryablebooleanrequired

okbooleanrequired

toolNamestringrequired

401

Missing, invalid or expired bearer credential.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

403

The credential lacks required permissions.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

404

The machine API or requested tool is unavailable.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

413

The request exceeds the byte limit.

errorobjectrequired

Show properties

codestringrequired

Allowed:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringrequired

min length 1 · max length 2048

retryablebooleanrequired

okbooleanrequired

toolNamestringrequired

429

Rate limit exceeded. The error is retryable.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

503

The API or its upstream execution is unavailable.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

Request

curl -X POST 'https://influence.so/api/v1/tools/string/confirm' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Publish-Confirmation: stringstringstringstringstringst' \
  -H 'Idempotency-Key: stringstringstri' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "property1": "string",
    "property2": "string"
  }
}'

const response = await fetch("https://influence.so/api/v1/tools/string/confirm", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "X-Publish-Confirmation": "stringstringstringstringstringst",
    "Idempotency-Key": "stringstringstri",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"input\": {\n    \"property1\": \"string\",\n    \"property2\": \"string\"\n  }\n}"
});

import requests

response = requests.post(
    "https://influence.so/api/v1/tools/string/confirm",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "X-Publish-Confirmation": "stringstringstringstringstringst",
        "Idempotency-Key": "stringstringstri",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"input\": {\n    \"property1\": \"string\",\n    \"property2\": \"string\"\n  }\n}",
)

Response

{
  "ok": true,
  "output": "string",
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "string",
    "retryable": true
  },
  "ok": false,
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}