Ludus 2 is in BETA. This API is subject to change until Ludus 2 is released.

Move one or more Ansible roles between local and global scopes

Cloud Mock

https://mock.apidog.com/m1/1126461-0-default

PATCH

/ansible/role/scope

Moves one or more installed Ansible roles between local (user) and global (server-wide) installation scopes without requiring reinstallation.
The role directories are copied to the target location and removed from the source location.
This endpoint requires administrator privileges. Admins can pass a userID parameter to move roles for other users.
Returns a response with arrays of successfully moved roles and any errors encountered.

Request

Authorization

Query Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Role move operation completed (may include partial success)

Body

🟠400Bad Request

🟠403Forbidden

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://mock.apidog.com/m1/1126461-0-default/ansible/role/scope?userID=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "roles": [
        "geerlingguy.docker",
        "geerlingguy.java"
    ],
    "global": true
}'

Response Example

200 - Example 1

{
    "success": [
        "geerlingguy.docker"
    ],
    "errors": [
        {
            "role": "geerlingguy.java",
            "error": "Role 'geerlingguy.java' not found"
        }
    ]
}

Modified at 2026-01-16 17:37:17

Get role variables for one or more Ansible roles

Retrieve available Ansible roles and collections