Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. Auth0 Provider
  3. API Docs
  4. Action
Auth0 v3.20.0 published on Wednesday, May 21, 2025 by Pulumi
pulumi/pulumi-auth0

auth0.Action

Explore with Pulumi AI

auth0 logo
Auth0 v3.20.0 published on Wednesday, May 21, 2025 by Pulumi
pulumi/pulumi-auth0

    Actions are secure, tenant-specific, versioned functions written in Node.js that execute at certain points during the Auth0 runtime. Actions are used to customize and extend Auth0’s capabilities with custom logic.

    An action bound to a trigger cannot be deleted. To destroy such an action, the trigger binding must first be deleted. A binding is usually managed by auth0.TriggerAction resource. The provider also supports a 1:many variant auth0_trigger_actions. If by any means, a binding is missing is the state file, it can be imported to the state and deleted, before attempting to delete the action.

    Create Action Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Action(name: string, args: ActionArgs, opts?: CustomResourceOptions);
    @overload
def Action(resource_name: str,
           args: ActionArgs,
           opts: Optional[ResourceOptions] = None)

@overload
def Action(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           code: Optional[str] = None,
           supported_triggers: Optional[ActionSupportedTriggersArgs] = None,
           dependencies: Optional[Sequence[ActionDependencyArgs]] = None,
           deploy: Optional[bool] = None,
           name: Optional[str] = None,
           runtime: Optional[str] = None,
           secrets: Optional[Sequence[ActionSecretArgs]] = None)
    func NewAction(ctx *Context, name string, args ActionArgs, opts ...ResourceOption) (*Action, error)
    public Action(string name, ActionArgs args, CustomResourceOptions? opts = null)
    public Action(String name, ActionArgs args)
public Action(String name, ActionArgs args, CustomResourceOptions options)

    type: auth0:Action
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var actionResource = new Auth0.Action("actionResource", new()
{
    Code = "string",
    SupportedTriggers = new Auth0.Inputs.ActionSupportedTriggersArgs
    {
        Id = "string",
        Version = "string",
    },
    Dependencies = new[]
    {
        new Auth0.Inputs.ActionDependencyArgs
        {
            Name = "string",
            Version = "string",
        },
    },
    Deploy = false,
    Name = "string",
    Runtime = "string",
    Secrets = new[]
    {
        new Auth0.Inputs.ActionSecretArgs
        {
            Name = "string",
            Value = "string",
        },
    },
});

    example, err := auth0.NewAction(ctx, "actionResource", &auth0.ActionArgs{
	Code: pulumi.String("string"),
	SupportedTriggers: &auth0.ActionSupportedTriggersArgs{
		Id:      pulumi.String("string"),
		Version: pulumi.String("string"),
	},
	Dependencies: auth0.ActionDependencyArray{
		&auth0.ActionDependencyArgs{
			Name:    pulumi.String("string"),
			Version: pulumi.String("string"),
		},
	},
	Deploy:  pulumi.Bool(false),
	Name:    pulumi.String("string"),
	Runtime: pulumi.String("string"),
	Secrets: auth0.ActionSecretArray{
		&auth0.ActionSecretArgs{
			Name:  pulumi.String("string"),
			Value: pulumi.String("string"),
		},
	},
})

    var actionResource = new Action("actionResource", ActionArgs.builder()
    .code("string")
    .supportedTriggers(ActionSupportedTriggersArgs.builder()
        .id("string")
        .version("string")
        .build())
    .dependencies(ActionDependencyArgs.builder()
        .name("string")
        .version("string")
        .build())
    .deploy(false)
    .name("string")
    .runtime("string")
    .secrets(ActionSecretArgs.builder()
        .name("string")
        .value("string")
        .build())
    .build());

    action_resource = auth0.Action("actionResource",
    code="string",
    supported_triggers={
        "id": "string",
        "version": "string",
    },
    dependencies=[{
        "name": "string",
        "version": "string",
    }],
    deploy=False,
    name="string",
    runtime="string",
    secrets=[{
        "name": "string",
        "value": "string",
    }])

    const actionResource = new auth0.Action("actionResource", {
    code: "string",
    supportedTriggers: {
        id: "string",
        version: "string",
    },
    dependencies: [{
        name: "string",
        version: "string",
    }],
    deploy: false,
    name: "string",
    runtime: "string",
    secrets: [{
        name: "string",
        value: "string",
    }],
});

    type: auth0:Action
properties:
    code: string
    dependencies:
        - name: string
          version: string
    deploy: false
    name: string
    runtime: string
    secrets:
        - name: string
          value: string
    supportedTriggers:
        id: string
        version: string

    Action Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Action resource accepts the following input properties:

    Code string
    The source code of the action.
    SupportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    Dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    Secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    Code string
    The source code of the action.
    SupportedTriggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    Dependencies []ActionDependencyArgs
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    Secrets []ActionSecretArgs
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    code String
    The source code of the action.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    code string
    The source code of the action.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies ActionDependency[]
    List of third party npm modules, and their versions, that this action depends on.
    deploy boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name string
    The name of the action.
    runtime string
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    secrets ActionSecret[]
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    code str
    The source code of the action.
    supported_triggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies Sequence[ActionDependencyArgs]
    List of third party npm modules, and their versions, that this action depends on.
    deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name str
    The name of the action.
    runtime str
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    secrets Sequence[ActionSecretArgs]
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    code String
    The source code of the action.
    supportedTriggers Property Map
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies List<Property Map>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    secrets List<Property Map>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Action resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    Id string
    The provider-assigned unique ID for this managed resource.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    id String
    The provider-assigned unique ID for this managed resource.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.
    id string
    The provider-assigned unique ID for this managed resource.
    versionId string
    Version ID of the action. This value is available if deploy is set to true.
    id str
    The provider-assigned unique ID for this managed resource.
    version_id str
    Version ID of the action. This value is available if deploy is set to true.
    id String
    The provider-assigned unique ID for this managed resource.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.

    Look up Existing Action Resource

    Get an existing Action resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: ActionState, opts?: CustomResourceOptions): Action
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        code: Optional[str] = None,
        dependencies: Optional[Sequence[ActionDependencyArgs]] = None,
        deploy: Optional[bool] = None,
        name: Optional[str] = None,
        runtime: Optional[str] = None,
        secrets: Optional[Sequence[ActionSecretArgs]] = None,
        supported_triggers: Optional[ActionSupportedTriggersArgs] = None,
        version_id: Optional[str] = None) -> Action
    func GetAction(ctx *Context, name string, id IDInput, state *ActionState, opts ...ResourceOption) (*Action, error)
    public static Action Get(string name, Input<string> id, ActionState? state, CustomResourceOptions? opts = null)
    public static Action get(String name, Output<String> id, ActionState state, CustomResourceOptions options)
    resources:  _:    type: auth0:Action    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Code string
    The source code of the action.
    Dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    Secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    SupportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    Code string
    The source code of the action.
    Dependencies []ActionDependencyArgs
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    Secrets []ActionSecretArgs
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    SupportedTriggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    code String
    The source code of the action.
    dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.
    code string
    The source code of the action.
    dependencies ActionDependency[]
    List of third party npm modules, and their versions, that this action depends on.
    deploy boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name string
    The name of the action.
    runtime string
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    secrets ActionSecret[]
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    versionId string
    Version ID of the action. This value is available if deploy is set to true.
    code str
    The source code of the action.
    dependencies Sequence[ActionDependencyArgs]
    List of third party npm modules, and their versions, that this action depends on.
    deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name str
    The name of the action.
    runtime str
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    secrets Sequence[ActionSecretArgs]
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    supported_triggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    version_id str
    Version ID of the action. This value is available if deploy is set to true.
    code String
    The source code of the action.
    dependencies List<Property Map>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Possible values are: node12, node16 (not recommended), node18, node22
    secrets List<Property Map>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    supportedTriggers Property Map
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.

    Supporting Types

    ActionDependency, ActionDependencyArgs

    Name string
    Dependency name, e.g. lodash.
    Version string
    Dependency version, e.g. latest or 4.17.21.
    Name string
    Dependency name, e.g. lodash.
    Version string
    Dependency version, e.g. latest or 4.17.21.
    name String
    Dependency name, e.g. lodash.
    version String
    Dependency version, e.g. latest or 4.17.21.
    name string
    Dependency name, e.g. lodash.
    version string
    Dependency version, e.g. latest or 4.17.21.
    name str
    Dependency name, e.g. lodash.
    version str
    Dependency version, e.g. latest or 4.17.21.
    name String
    Dependency name, e.g. lodash.
    version String
    Dependency version, e.g. latest or 4.17.21.

    ActionSecret, ActionSecretArgs

    Name string
    Secret name.
    Value string
    Secret value.
    Name string
    Secret name.
    Value string
    Secret value.
    name String
    Secret name.
    value String
    Secret value.
    name string
    Secret name.
    value string
    Secret value.
    name str
    Secret name.
    value str
    Secret value.
    name String
    Secret name.
    value String
    Secret value.

    ActionSupportedTriggers, ActionSupportedTriggersArgs

    Id string
    The trigger ID.
    Version string
    The trigger version. This regulates which runtime versions are supported.
    Id string
    The trigger ID.
    Version string
    The trigger version. This regulates which runtime versions are supported.
    id String
    The trigger ID.
    version String
    The trigger version. This regulates which runtime versions are supported.
    id string
    The trigger ID.
    version string
    The trigger version. This regulates which runtime versions are supported.
    id str
    The trigger ID.
    version str
    The trigger version. This regulates which runtime versions are supported.
    id String
    The trigger ID.
    version String
    The trigger version. This regulates which runtime versions are supported.

    Import

    This resource can be imported by specifying the action ID.

    Example:

    $ pulumi import auth0:index/action:Action my_action "12f4f21b-017a-319d-92e7-2291c1ca36c4"

    ~> For security reasons importing secrets is not allowed. Therefore, it is advised to import

    the action without secrets and adding them back after the action has been imported.

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    Auth0 pulumi/pulumi-auth0
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the auth0 Terraform Provider.
    auth0 logo
    Auth0 v3.20.0 published on Wednesday, May 21, 2025 by Pulumi
    pulumi/pulumi-auth0