meta {
  name: Assign Role
  type: http
  seq: 1
}

post {
  url: {{appview_url}}/api/admin/members/:did/role
}

params:path {
  did: {{target_user_did}}
}

body:json {
  {
    "roleUri": "at://{{forum_did}}/space.atbb.forum.role/{{role_rkey}}"
  }
}

assert {
  res.status: eq 200
  res.body.success: isDefined
  res.body.roleAssigned: isDefined
}

docs {
  Assign a role to a forum member.

  **Requires:** `space.atbb.permission.manageRoles` permission

  Path params:
  - did: Target user's DID (required)

  Body params:
  - roleUri: Full AT URI of the role to assign (required, format: at://FORUM_DID/space.atbb.forum.role/RKEY)

  Returns:
  {
    "success": true,
    "roleAssigned": "Moderator",
    "targetDid": "did:plc:user123"
  }

  Error codes:
  - 400: Invalid roleUri format
  - 401: Not authenticated  
  - 403: Insufficient permissions or priority hierarchy violation
  - 404: Role or user membership not found
  - 500: Forum agent not available or forum record missing
  - 503: Unable to reach user's PDS

  Priority hierarchy:
  - Cannot assign role with equal or higher authority than your own
  - Lower priority value = higher authority (Owner=0, Admin=10, Moderator=20, Member=30)
}