Paigo ACTION
Create Dimension
Creates a new dimension inside the Paigo platform. See the documentation
- Action
- Writes data
- OAuth
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Paigo account once, then configure and run Create Dimension from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "paigo-create-dimension",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
paigo: { authProvisionId: "apn_xxxxxxx" },
dimensionName: "Dimension Name",
consumptionUnitType: "Consumption Unit Type",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "paigo-create-dimension",
"configured_props": {
"paigo": { "authProvisionId": "apn_xxxxxxx" },
"dimensionName": "Dimension Name",
"consumptionUnitType": "Consumption Unit Type"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "paigo",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "paigo-create-dimension",
arguments: {
dimensionName: "Dimension Name",
consumptionUnitType: "Consumption Unit Type",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
dimensionName Dimension Name | string | A friendly, human-readable name for the dimension Required |
consumptionUnitType Consumption Unit Type | string | Consumption unit type of the dimension Required |
consumptionUnit Consumption Unit | string | Consumption unit type of the dimension Required Dynamic |
usageIncrement Usage Increment | string | The minimum increment for usage amount. As an example, if usage increment is 1 Hour job execution time, then 1 Hour and 5 Minutes execution time may be calculated as 1 Hour or 2 Hours, depending on the rounding algorithm field of the dimension. Required |
rounding Rounding | string | The rounding algorithm that is used to calculate the amount of usage increment. Ceiling algorithm rounds up, floor algorithm rounds down, the round algorithm rounds to the nearest whole integer rounding half away from zero. Required |
usageEntitlement Usage Entitlement | string | Used with Subscription Tier Offering type. SaaS customers subscribed to a subscription tier are entitled to use the amount of product with regard to the dimension up to the value specified in this field. For example, a subscription tier may entitle subscribers to make up to 1,000,000 API requests. Optional |
overageAllowed Overage Allowed | string | Used with Subscription Tier Offering type. When the usage entitlement is specified, this field decides if allowing SaaS customers to use more than entitled amount of the product dimension. Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- paigo-create-dimension
- Version
- 0.0.3
- App
- Paigo
- Authentication
- OAuth
- Read-only
- No
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗