View as Markdown
Ramp icon

Ramp ACTION

Get Limit

Retrieve a single Ramp spend limit by ID. Run the List Limits action first to find a valid limit ID. Example: given a limit id from List Limits, returns the limit's display name, state (e.g. ACTIVE), balance, spend program, and spending restrictions. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Ramp account once, then configure and run Get Limit 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: "ramp-get-limit",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    ramp: { authProvisionId: "apn_xxxxxxx" },
    limitId: "Limit ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get Limit inputs
Property Type Description
limitId Limit ID string
The ID of the spend limit to retrieve — a UUID, e.g. dcd0f7a8-557d-4dc5-bb12-49297c3abfdd. Run the List Limits action to find this value.
Required

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
ramp-get-limit
Version
0.0.3
App
Ramp
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes