View as Markdown
Permit.io icon

Permit.io ACTION

Assign Role

Grants a specific role to a user within a tenant to enable immediate access to protected resources. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Permit.io account once, then configure and run Assign Role 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: "permit_io-assign-role",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    permit_io: { authProvisionId: "apn_xxxxxxx" },
    projId: "Project ID",
    envId: "Environment 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.

Assign Role inputs
Property Type Description
projId Project ID string
The project key or ID
Required Dynamic
envId Environment ID string
The environment key or ID
Required Dynamic
role Role string
The role key or ID (e.g. admin, editor)
Required Dynamic
user User string
The user key or ID (e.g. jane@example.com)
Required Dynamic
tenant Tenant string
The tenant key or ID (e.g. stripe-inc)
Optional Dynamic
resourceInstance Resource Instance string
The resource instance the role is associated with. Use the format resource_type:resource_instance_key (e.g. repo:opal). The instance will be implicitly created if Tenant is specified and it does not exist.
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
permit_io-assign-role
Version
0.0.2
App
Permit.io
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes