AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
TypeScript ai-agentai-agent-toolsai-agentsai-agents-frameworkmcpmcp-servermcp-toolsmcpsn8n-alternativeno-code-automationworkflowworkflow-automationworkflows
import { createAction, Property } from '@activepieces/pieces-framework';
import { cloudinaryAuth } from '../common/auth';
import { makeRequest } from '../common/client';
import { HttpMethod } from '@activepieces/pieces-common';
export const createUsageReport = createAction({
auth: cloudinaryAuth,
name: 'createUsageReport',
classification: 'READ',
displayName: 'Create Usage Report',
description: 'Generate a comprehensive report of account usage and quotas including storage, bandwidth, transformations, requests, and add-on usage.',
audience: 'human',
aiMetadata: { description: 'Reads the Cloudinary account usage and quota figures (storage, bandwidth, transformations, requests, add-ons) for an optional date within the last three months. Use to check current consumption against plan limits. Read-only and idempotent; despite the name it creates nothing.', idempotent: true },
props: {
date: Property.DateTime({
displayName: 'Report Date',
description: 'Date for the usage report. Must be within the last 3 months. Leave empty for current date.',
required: false,
}),
include_breakdown: Property.Checkbox({
displayName: 'Include Detailed Breakdown',
description: 'Whether to include detailed breakdown of transformation types and add-on usage in the response.',
required: false,
defaultValue: true,
}),
},
async run({ auth, propsValue }) {
const { date, include_breakdown } = propsValue;
if (date) {
const inputDate = new Date(date);
const threeMonthsAgo = new Date();
threeMonthsAgo.setMonth(threeMonthsAgo.getMonth() - 3);
if (inputDate < threeMonthsAgo) {
throw new Error('Date must be within the last 3 months');
}
if (inputDate > new Date()) {
throw new Error('Date cannot be in the future');
}
}
const queryParams: Record<string, string> = {};
if (date) {
const inputDate = new Date(date);
const dateString = inputDate.toISOString().split('T')[0];
queryParams['date'] = dateString;
}
const path = `/usage`;
const response = await makeRequest(auth, HttpMethod.GET, path, undefined, queryParams);
if (!include_breakdown && response) {
const simplified = {
plan: response.plan,
last_updated: response.last_updated,
date_requested: response.date_requested,
summary: {
transformations: {
usage: response.transformations?.usage,
limit: response.transformations?.limit,
used_percent: response.transformations?.used_percent,
},
bandwidth: {
usage: response.bandwidth?.usage,
limit: response.bandwidth?.limit,
used_percent: response.bandwidth?.used_percent,
usage_gb: response.bandwidth?.usage ? Math.round(response.bandwidth.usage / (1024 * 1024 * 1024) * 100) / 100 : null,
},
storage: {
usage: response.storage?.usage,
limit: response.storage?.limit,
used_percent: response.storage?.used_percent,
usage_gb: response.storage?.usage ? Math.round(response.storage.usage / (1024 * 1024 * 1024) * 100) / 100 : null,
},
requests: response.requests,
resources: response.resources,
derived_resources: response.derived_resources,
},
media_limits: response.media_limits,
};
return simplified;
}
if (response) {
if (response.bandwidth?.usage) {
response.bandwidth.usage_gb = Math.round(response.bandwidth.usage / (1024 * 1024 * 1024) * 100) / 100;
}
if (response.storage?.usage) {
response.storage.usage_gb = Math.round(response.storage.usage / (1024 * 1024 * 1024) * 100) / 100;
}
}
return response;
},
});