Capabilities

update_team_member

Change an ID-owned membership with optimistic version safety; roles cap every subsequent API request.

How this capability is exposed

Stable ID: ursy.cloud:update_team_member
Owning service: URSY.cloud
Runtime: See the source declaration

Capability declarations describe what the service exposes. They are not a guarantee of availability or permission to execute an operation.

Accepted contract

REGISTRY JSON

{
    "id": "ursy.cloud:update_team_member",
    "name": "update_team_member",
    "description": "Change an ID-owned membership with optimistic version safety; roles cap every subsequent API request.",
    "method": "POST",
    "path": "/v1/teams/{organisation_id}/members/{subject}",
    "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
            "organisation_id": {
                "type": "string",
                "maxLength": 128,
                "x-ursy-maxBytes": 128
            },
            "subject": {
                "type": "string",
                "maxLength": 128,
                "x-ursy-maxBytes": 128
            },
            "role": {
                "type": "string",
                "enum": [
                    "owner",
                    "admin",
                    "editor",
                    "commenter",
                    "viewer"
                ]
            },
            "state": {
                "type": "string",
                "enum": [
                    "ACTIVE",
                    "SUSPENDED",
                    "REVOKED"
                ]
            },
            "expected_version": {
                "type": "integer",
                "minimum": 0
            },
            "idempotency_key": {
                "type": "string",
                "minLength": 8,
                "maxLength": 128,
                "pattern": "^[A-Za-z0-9._:-]+$"
            }
        },
        "required": [
            "organisation_id",
            "subject",
            "role",
            "state",
            "expected_version",
            "idempotency_key"
        ]
    },
    "outputSchema": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
            "result": {
                "type": "object",
                "additionalProperties": true
            }
        },
        "required": [
            "result"
        ]
    },
    "auth_required": true,
    "scope": "cloud.teams.manage",
    "read_only": false,
    "service_id": "ursy-cloud",
    "parent_id": "",
    "summary": "Change an ID-owned membership with optimistic version safety; roles cap every subsequent API request.",
    "source_url": "https://api.ursy.cloud/v1/registry-capabilities",
    "source_type": "capability_manifest",
    "verified_at": "2026-10-14 07:32:38",
    "revision": "d5b54448150257e99e48a12069b73d41d30f985d20afee69c73bcad6ec584a1f",
    "type": "capabilities",
    "source": {
        "url": "https://api.ursy.cloud/v1/registry-capabilities",
        "type": "capability_manifest"
    },
    "last_verified_at": "2026-10-14 07:32:38",
    "stale": false
}