{
  "service": "auth0_management",
  "displayName": "Auth0 Management",
  "categories": [
    "Security"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "Management API access token",
      "placeholder": "AUTH0_MANAGEMENT_API_TOKEN",
      "description": "Auth0 Management API access token sent as a Bearer token. Create a Machine-to-Machine application and authorize it for the Auth0 Management API.",
      "extraFields": [
        {
          "key": "domain",
          "label": "Tenant domain",
          "inputType": "text",
          "required": true,
          "secret": false,
          "placeholder": "example.us.auth0.com",
          "description": "Auth0 tenant domain used to build https://TENANT_DOMAIN/api/v2 requests. Use the domain from your Auth0 application or tenant settings."
        }
      ]
    }
  ],
  "homepageUrl": "https://auth0.com",
  "actions": [
    {
      "id": "auth0_management.add_permissions_to_role",
      "service": "auth0_management",
      "name": "add_permissions_to_role",
      "description": "Associate one or more Auth0 permissions with a role.",
      "requiredScopes": [],
      "providerPermissions": [
        "update:roles"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "roleId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 role ID, such as rol_abc123."
          },
          "permissions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "permissionName": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The Auth0 permission name, mapped to permission_name."
                },
                "resourceServerIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The Auth0 resource server identifier, mapped to resource_server_identifier."
                }
              },
              "additionalProperties": false,
              "required": [
                "permissionName",
                "resourceServerIdentifier"
              ],
              "description": "An Auth0 Management API permission reference."
            },
            "description": "Auth0 permissions to associate with or remove from the role.",
            "minItems": 1
          }
        },
        "additionalProperties": false,
        "required": [
          "roleId",
          "permissions"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Whether the Auth0 role update request completed successfully."
          }
        },
        "additionalProperties": false,
        "required": [
          "success"
        ],
        "description": "Auth0 role update result."
      }
    },
    {
      "id": "auth0_management.assign_roles_to_user",
      "service": "auth0_management",
      "name": "assign_roles_to_user",
      "description": "Assign one or more Auth0 roles to a user.",
      "requiredScopes": [],
      "providerPermissions": [
        "update:users",
        "create:role_members"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 user ID, such as auth0|abc123."
          },
          "roleIds": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "The Auth0 role ID, such as rol_abc123."
            },
            "description": "Auth0 role IDs to assign or remove.",
            "minItems": 1
          }
        },
        "additionalProperties": false,
        "required": [
          "userId",
          "roleIds"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Whether the Auth0 role update request completed successfully."
          }
        },
        "additionalProperties": false,
        "required": [
          "success"
        ],
        "description": "Auth0 role update result."
      }
    },
    {
      "id": "auth0_management.get_role",
      "service": "auth0_management",
      "name": "get_role",
      "description": "Retrieve one Auth0 role by role ID.",
      "requiredScopes": [],
      "providerPermissions": [
        "read:roles"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "roleId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 role ID, such as rol_abc123."
          }
        },
        "additionalProperties": false,
        "required": [
          "roleId"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "role": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "A raw Auth0 Management API object."
          }
        },
        "additionalProperties": false,
        "required": [
          "role"
        ],
        "description": "Auth0 role details."
      }
    },
    {
      "id": "auth0_management.get_user",
      "service": "auth0_management",
      "name": "get_user",
      "description": "Retrieve one Auth0 user by user ID.",
      "requiredScopes": [],
      "providerPermissions": [
        "read:users"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 user ID, such as auth0|abc123."
          }
        },
        "additionalProperties": false,
        "required": [
          "userId"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "user": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "A raw Auth0 Management API object."
          }
        },
        "additionalProperties": false,
        "required": [
          "user"
        ],
        "description": "Auth0 user details."
      }
    },
    {
      "id": "auth0_management.list_role_permissions",
      "service": "auth0_management",
      "name": "list_role_permissions",
      "description": "List permissions granted by an Auth0 role.",
      "requiredScopes": [],
      "providerPermissions": [
        "read:roles"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "roleId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 role ID, such as rol_abc123."
          },
          "page": {
            "type": "integer",
            "minimum": 0,
            "description": "Zero-based Auth0 page number to request."
          },
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of Auth0 records to return per page."
          },
          "includeTotals": {
            "type": "boolean",
            "description": "Whether Auth0 should return a totals wrapper."
          }
        },
        "additionalProperties": false,
        "required": [
          "roleId"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "permissions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A raw Auth0 Management API object."
            },
            "description": "Auth0 permissions returned by the Management API."
          },
          "raw": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A raw Auth0 Management API object."
                },
                "description": "The raw Auth0 Management API array response."
              },
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A raw Auth0 Management API object."
              }
            ],
            "description": "The raw Auth0 Management API list response."
          }
        },
        "additionalProperties": false,
        "required": [
          "permissions",
          "raw"
        ],
        "description": "List of Auth0 permissions."
      }
    },
    {
      "id": "auth0_management.list_role_users",
      "service": "auth0_management",
      "name": "list_role_users",
      "description": "List users assigned to an Auth0 role with offset or checkpoint pagination.",
      "requiredScopes": [],
      "providerPermissions": [
        "read:roles",
        "read:users",
        "read:role_members"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "roleId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 role ID, such as rol_abc123."
          },
          "page": {
            "type": "integer",
            "minimum": 0,
            "description": "Zero-based Auth0 page number to request."
          },
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of Auth0 records to return per page."
          },
          "includeTotals": {
            "type": "boolean",
            "description": "Whether Auth0 should return a totals wrapper."
          },
          "from": {
            "type": "string",
            "minLength": 1,
            "description": "Auth0 checkpoint pagination cursor."
          },
          "take": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of Auth0 users to retrieve with checkpoint pagination."
          }
        },
        "additionalProperties": false,
        "required": [
          "roleId"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "users": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A raw Auth0 Management API object."
            },
            "description": "Auth0 users returned by the Management API."
          },
          "raw": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A raw Auth0 Management API object."
                },
                "description": "The raw Auth0 Management API array response."
              },
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A raw Auth0 Management API object."
              }
            ],
            "description": "The raw Auth0 Management API list response."
          }
        },
        "additionalProperties": false,
        "required": [
          "users",
          "raw"
        ],
        "description": "List of Auth0 users."
      }
    },
    {
      "id": "auth0_management.list_roles",
      "service": "auth0_management",
      "name": "list_roles",
      "description": "List Auth0 roles with pagination and optional name filter.",
      "requiredScopes": [],
      "providerPermissions": [
        "read:roles"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 0,
            "description": "Zero-based Auth0 page number to request."
          },
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of Auth0 records to return per page."
          },
          "includeTotals": {
            "type": "boolean",
            "description": "Whether Auth0 should return a totals wrapper."
          },
          "nameFilter": {
            "type": "string",
            "minLength": 1,
            "description": "A role name filter passed to Auth0 as name_filter."
          }
        },
        "additionalProperties": false,
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "roles": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A raw Auth0 Management API object."
            },
            "description": "Auth0 roles returned by the Management API."
          },
          "raw": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A raw Auth0 Management API object."
                },
                "description": "The raw Auth0 Management API array response."
              },
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A raw Auth0 Management API object."
              }
            ],
            "description": "The raw Auth0 Management API list response."
          }
        },
        "additionalProperties": false,
        "required": [
          "roles",
          "raw"
        ],
        "description": "List of Auth0 roles."
      }
    },
    {
      "id": "auth0_management.list_user_effective_permissions",
      "service": "auth0_management",
      "name": "list_user_effective_permissions",
      "description": "List Auth0 permissions granted to a user directly or through roles or groups.",
      "requiredScopes": [],
      "providerPermissions": [
        "read:user_effective_permissions"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 user ID, such as auth0|abc123."
          },
          "page": {
            "type": "integer",
            "minimum": 0,
            "description": "Zero-based Auth0 page number to request."
          },
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of Auth0 records to return per page."
          },
          "includeTotals": {
            "type": "boolean",
            "description": "Whether Auth0 should return a totals wrapper."
          }
        },
        "additionalProperties": false,
        "required": [
          "userId"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "permissions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A raw Auth0 Management API object."
            },
            "description": "Auth0 permissions returned by the Management API."
          },
          "raw": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A raw Auth0 Management API object."
                },
                "description": "The raw Auth0 Management API array response."
              },
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A raw Auth0 Management API object."
              }
            ],
            "description": "The raw Auth0 Management API list response."
          }
        },
        "additionalProperties": false,
        "required": [
          "permissions",
          "raw"
        ],
        "description": "List of Auth0 permissions."
      }
    },
    {
      "id": "auth0_management.list_user_effective_roles",
      "service": "auth0_management",
      "name": "list_user_effective_roles",
      "description": "List Auth0 roles granted to a user directly or through group membership.",
      "requiredScopes": [],
      "providerPermissions": [
        "read:user_effective_roles"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 user ID, such as auth0|abc123."
          },
          "page": {
            "type": "integer",
            "minimum": 0,
            "description": "Zero-based Auth0 page number to request."
          },
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of Auth0 records to return per page."
          },
          "includeTotals": {
            "type": "boolean",
            "description": "Whether Auth0 should return a totals wrapper."
          }
        },
        "additionalProperties": false,
        "required": [
          "userId"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "roles": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A raw Auth0 Management API object."
            },
            "description": "Auth0 roles returned by the Management API."
          },
          "raw": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A raw Auth0 Management API object."
                },
                "description": "The raw Auth0 Management API array response."
              },
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A raw Auth0 Management API object."
              }
            ],
            "description": "The raw Auth0 Management API list response."
          }
        },
        "additionalProperties": false,
        "required": [
          "roles",
          "raw"
        ],
        "description": "List of Auth0 roles."
      }
    },
    {
      "id": "auth0_management.list_user_permissions",
      "service": "auth0_management",
      "name": "list_user_permissions",
      "description": "List permissions directly assigned to an Auth0 user.",
      "requiredScopes": [],
      "providerPermissions": [
        "read:users"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 user ID, such as auth0|abc123."
          },
          "page": {
            "type": "integer",
            "minimum": 0,
            "description": "Zero-based Auth0 page number to request."
          },
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of Auth0 records to return per page."
          },
          "includeTotals": {
            "type": "boolean",
            "description": "Whether Auth0 should return a totals wrapper."
          }
        },
        "additionalProperties": false,
        "required": [
          "userId"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "permissions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A raw Auth0 Management API object."
            },
            "description": "Auth0 permissions returned by the Management API."
          },
          "raw": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A raw Auth0 Management API object."
                },
                "description": "The raw Auth0 Management API array response."
              },
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A raw Auth0 Management API object."
              }
            ],
            "description": "The raw Auth0 Management API list response."
          }
        },
        "additionalProperties": false,
        "required": [
          "permissions",
          "raw"
        ],
        "description": "List of Auth0 permissions."
      }
    },
    {
      "id": "auth0_management.list_user_roles",
      "service": "auth0_management",
      "name": "list_user_roles",
      "description": "List Auth0 roles assigned to a user.",
      "requiredScopes": [],
      "providerPermissions": [
        "read:users",
        "read:roles",
        "read:role_members"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 user ID, such as auth0|abc123."
          },
          "page": {
            "type": "integer",
            "minimum": 0,
            "description": "Zero-based Auth0 page number to request."
          },
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of Auth0 records to return per page."
          },
          "includeTotals": {
            "type": "boolean",
            "description": "Whether Auth0 should return a totals wrapper."
          }
        },
        "additionalProperties": false,
        "required": [
          "userId"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "roles": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A raw Auth0 Management API object."
            },
            "description": "Auth0 roles returned by the Management API."
          },
          "raw": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A raw Auth0 Management API object."
                },
                "description": "The raw Auth0 Management API array response."
              },
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A raw Auth0 Management API object."
              }
            ],
            "description": "The raw Auth0 Management API list response."
          }
        },
        "additionalProperties": false,
        "required": [
          "roles",
          "raw"
        ],
        "description": "List of Auth0 roles."
      }
    },
    {
      "id": "auth0_management.list_users",
      "service": "auth0_management",
      "name": "list_users",
      "description": "List Auth0 users with pagination and optional Lucene search query.",
      "requiredScopes": [],
      "providerPermissions": [
        "read:users"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 0,
            "description": "Zero-based Auth0 page number to request."
          },
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of Auth0 records to return per page."
          },
          "includeTotals": {
            "type": "boolean",
            "description": "Whether Auth0 should return a totals wrapper."
          },
          "query": {
            "type": "string",
            "minLength": 1,
            "description": "Auth0 user search query in Lucene syntax."
          }
        },
        "additionalProperties": false,
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "users": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A raw Auth0 Management API object."
            },
            "description": "Auth0 users returned by the Management API."
          },
          "raw": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A raw Auth0 Management API object."
                },
                "description": "The raw Auth0 Management API array response."
              },
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A raw Auth0 Management API object."
              }
            ],
            "description": "The raw Auth0 Management API list response."
          }
        },
        "additionalProperties": false,
        "required": [
          "users",
          "raw"
        ],
        "description": "List of Auth0 users."
      }
    },
    {
      "id": "auth0_management.remove_permissions_from_role",
      "service": "auth0_management",
      "name": "remove_permissions_from_role",
      "description": "Remove one or more Auth0 permissions from a role.",
      "requiredScopes": [],
      "providerPermissions": [
        "update:roles"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "roleId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 role ID, such as rol_abc123."
          },
          "permissions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "permissionName": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The Auth0 permission name, mapped to permission_name."
                },
                "resourceServerIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The Auth0 resource server identifier, mapped to resource_server_identifier."
                }
              },
              "additionalProperties": false,
              "required": [
                "permissionName",
                "resourceServerIdentifier"
              ],
              "description": "An Auth0 Management API permission reference."
            },
            "description": "Auth0 permissions to associate with or remove from the role.",
            "minItems": 1
          }
        },
        "additionalProperties": false,
        "required": [
          "roleId",
          "permissions"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Whether the Auth0 role update request completed successfully."
          }
        },
        "additionalProperties": false,
        "required": [
          "success"
        ],
        "description": "Auth0 role update result."
      }
    },
    {
      "id": "auth0_management.remove_roles_from_user",
      "service": "auth0_management",
      "name": "remove_roles_from_user",
      "description": "Remove one or more Auth0 roles from a user.",
      "requiredScopes": [],
      "providerPermissions": [
        "update:users",
        "delete:role_members"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "minLength": 1,
            "description": "The Auth0 user ID, such as auth0|abc123."
          },
          "roleIds": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "The Auth0 role ID, such as rol_abc123."
            },
            "description": "Auth0 role IDs to assign or remove.",
            "minItems": 1
          }
        },
        "additionalProperties": false,
        "required": [
          "userId",
          "roleIds"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Whether the Auth0 role update request completed successfully."
          }
        },
        "additionalProperties": false,
        "required": [
          "success"
        ],
        "description": "Auth0 role update result."
      }
    },
    {
      "id": "auth0_management.search_users_by_email",
      "service": "auth0_management",
      "name": "search_users_by_email",
      "description": "Search Auth0 users by email with the official users-by-email endpoint.",
      "requiredScopes": [],
      "providerPermissions": [
        "read:users"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email address to search for.",
            "format": "email"
          }
        },
        "additionalProperties": false,
        "required": [
          "email"
        ],
        "description": "The input payload for this action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "users": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A raw Auth0 Management API object."
            },
            "description": "Auth0 users returned by the Management API."
          },
          "raw": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A raw Auth0 Management API object."
                },
                "description": "The raw Auth0 Management API array response."
              },
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A raw Auth0 Management API object."
              }
            ],
            "description": "The raw Auth0 Management API list response."
          }
        },
        "additionalProperties": false,
        "required": [
          "users",
          "raw"
        ],
        "description": "List of Auth0 users."
      }
    }
  ]
}