Discover available tools

Return tool names, descriptions, scopes, confirmation requirements and input schemas visible to the bearer credential.

GET/api/v1/tools

Authorization

AuthorizationBearer token · headerrequired

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

Responses

200

Available tool descriptors.

toolsobject[]required

Show properties

Array of object

annotationsobjectrequired

Show properties

destructiveHintbooleanrequired

idempotentHintbooleanrequired

openWorldHintbooleanrequired

readOnlyHintbooleanrequired

confirmationstringrequired

Allowed:nonerequired

descriptionstringrequired

min length 1 · max length 1024

gatestringrequired

Allowed:coregenerative-ai

mutabilitystringrequired

Allowed:readexternal-readwriteexternal-write

namestringrequired

Allowed:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

scopesstring[]required

max items 4

titlestringrequired

min length 1 · max length 80

inputSchemaobjectrequired

Show properties

typestringrequired

400

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

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

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

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 GET 'https://influence.so/api/v1/tools' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://influence.so/api/v1/tools", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://influence.so/api/v1/tools",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

Response

{
  "tools": [
    {
      "annotations": {
        "destructiveHint": true,
        "idempotentHint": true,
        "openWorldHint": true,
        "readOnlyHint": true
      },
      "confirmation": "none",
      "description": "string",
      "gate": "core",
      "mutability": "read",
      "name": "adAuditQuote",
      "scopes": [
        "integrations:read"
      ],
      "title": "string",
      "inputSchema": {
        "type": "object",
        "property1": "string",
        "property2": "string"
      },
      "property1": "string",
      "property2": "string"
    }
  ],
  "property1": "string",
  "property2": "string"
}

{
  "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": "string",
    "message": "string",
    "retryable": true
  }
}

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