Descobrir ferramentas disponíveis

Retorna nomes, descrições, escopos, requisitos de confirmação e esquemas de entrada das ferramentas visíveis à credencial bearer.

GET/api/v1/tools

Autorização

AuthorizationToken Bearer · headerobrigatório

Chave de API do Influence com escopos definidos ou token de acesso OAuth compatível. Mantenha credenciais fora de URLs e da entrada das ferramentas.

Respostas

200

Descritores das ferramentas disponíveis.

toolsobject[]obrigatório

Mostrar propriedades

Array de object

annotationsobjectobrigatório

Mostrar propriedades

destructiveHintbooleanobrigatório

idempotentHintbooleanobrigatório

openWorldHintbooleanobrigatório

readOnlyHintbooleanobrigatório

confirmationstringobrigatório

Valores permitidos:nonerequired

descriptionstringobrigatório

comprimento mínimo: 1 · comprimento máximo: 1024

gatestringobrigatório

Valores permitidos:coregenerative-ai

mutabilitystringobrigatório

Valores permitidos:readexternal-readwriteexternal-write

namestringobrigatório

Valores permitidos:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

scopesstring[]obrigatório

máximo de itens: 4

titlestringobrigatório

comprimento mínimo: 1 · comprimento máximo: 80

inputSchemaobjectobrigatório

Mostrar propriedades

typestringobrigatório

400

Solicitação inválida. Parâmetros de consulta não são aceitos. Falhas de validação da ferramenta podem usar a estrutura de erro da ferramenta.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

401

Credencial bearer ausente, inválida ou expirada.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

403

A credencial não tem as permissões necessárias.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

404

A API para automações ou a ferramenta solicitada está indisponível.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

429

Limite de solicitações excedido. É possível tentar novamente após este erro.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

503

A API ou o serviço responsável pela execução está indisponível.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

Solicitação

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"
    },
)

Resposta

{
  "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
  }
}