Call a read-only tool

Call a read-only tool. Send {input: {…}} using the schema matching the path’s tool name. JSON requests are limited to 65,536 bytes. A 200 response can contain ok:false.

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

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.

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/call' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -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/call", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "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/call",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "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
  }
}