{"info":{"title":"group-users object","version":"1.0","contact":{"name":"Beamable Support","url":"https://api.beamable.com","email":"support@beamable.com"}},"servers":[{"url":"https://api.beamable.com"}],"paths":{"/object/group-users/{objectId}/availability":{"get":{"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityResponse"}}}},"400":{"description":"Bad Request"}},"parameters":[{"name":"name","in":"query","schema":{"type":"string"},"required":false},{"name":"tag","in":"query","schema":{"type":"string"},"required":false},{"name":"type","in":"query","schema":{"$ref":"#/components/schemas/GroupType"},"required":true},{"name":"subGroup","in":"query","schema":{"type":"boolean"},"required":false},{"name":"objectId","in":"path","schema":{"type":"string"},"description":"Gamertag of the player.Underlying objectId type is integer in format int64.","required":true,"x-beamable-object-id":{"type":"integer","format":"int64"}}],"security":[{}]},"parameters":[{"name":"X-BEAM-SCOPE","in":"header","schema":{"type":"string"},"description":"Customer and project scope. This should be in the form of '<customer-id>.<project-id>'.","required":true},{"name":"X-BEAM-GAMERTAG","in":"header","schema":{"type":"string"},"description":"Override the Gamer Tag of the player. This is generally inferred by the auth token.","required":false}]},"/object/group-users/{objectId}/recommended":{"get":{"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupSearchResponse"}}}},"400":{"description":"Bad Request"}},"parameters":[{"name":"objectId","in":"path","schema":{"type":"string"},"description":"Gamertag of the player.Underlying objectId type is integer in format int64.","required":true,"x-beamable-object-id":{"type":"integer","format":"int64"}}],"security":[{}]},"parameters":[{"name":"X-BEAM-SCOPE","in":"header","schema":{"type":"string"},"description":"Customer and project scope. This should be in the form of '<customer-id>.<project-id>'.","required":true},{"name":"X-BEAM-GAMERTAG","in":"header","schema":{"type":"string"},"description":"Override the Gamer Tag of the player. This is generally inferred by the auth token.","required":false}]},"/object/group-users/{objectId}/join":{"post":{"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupMembershipResponse"}}}},"400":{"description":"Bad Request"}},"parameters":[{"name":"objectId","in":"path","schema":{"type":"string"},"description":"Gamertag of the player.Underlying objectId type is integer in format int64.","required":true,"x-beamable-object-id":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupMembershipRequest"}}}},"security":[{}]},"delete":{"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupMembershipResponse"}}}},"400":{"description":"Bad Request"}},"parameters":[{"name":"objectId","in":"path","schema":{"type":"string"},"description":"Gamertag of the player.Underlying objectId type is integer in format int64.","required":true,"x-beamable-object-id":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupMembershipRequest"}}}},"security":[{}]},"parameters":[{"name":"X-BEAM-SCOPE","in":"header","schema":{"type":"string"},"description":"Customer and project scope. This should be in the form of '<customer-id>.<project-id>'.","required":true},{"name":"X-BEAM-GAMERTAG","in":"header","schema":{"type":"string"},"description":"Override the Gamer Tag of the player. This is generally inferred by the auth token.","required":false}]},"/object/group-users/{objectId}/group":{"post":{"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupCreateResponse"}}}},"400":{"description":"Bad Request"}},"parameters":[{"name":"objectId","in":"path","schema":{"type":"string"},"description":"Gamertag of the player.Underlying objectId type is integer in format int64.","required":true,"x-beamable-object-id":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupCreate"}}}},"security":[{}]},"parameters":[{"name":"X-BEAM-SCOPE","in":"header","schema":{"type":"string"},"description":"Customer and project scope. This should be in the form of '<customer-id>.<project-id>'.","required":true},{"name":"X-BEAM-GAMERTAG","in":"header","schema":{"type":"string"},"description":"Override the Gamer Tag of the player. This is generally inferred by the auth token.","required":false}]},"/object/group-users/{objectId}/search":{"get":{"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupSearchResponse"}}}},"400":{"description":"Bad Request"}},"parameters":[{"name":"name","in":"query","schema":{"type":"string"},"required":false},{"name":"scoreMin","in":"query","schema":{"type":"integer","format":"int64"},"required":false},{"name":"sortField","in":"query","schema":{"type":"string"},"required":false},{"name":"userScore","in":"query","schema":{"type":"integer","format":"int64"},"required":false},{"name":"hasSlots","in":"query","schema":{"type":"boolean"},"required":false},{"name":"enrollmentTypes","in":"query","schema":{"type":"string"},"required":false},{"name":"offset","in":"query","schema":{"type":"integer","format":"int32"},"required":false},{"name":"scoreMax","in":"query","schema":{"type":"integer","format":"int64"},"required":false},{"name":"subGroup","in":"query","schema":{"type":"boolean"},"required":false},{"name":"sortValue","in":"query","schema":{"type":"integer","format":"int32"},"required":false},{"name":"type","in":"query","schema":{"$ref":"#/components/schemas/GroupType"},"required":true},{"name":"limit","in":"query","schema":{"type":"integer","format":"int32"},"required":false},{"name":"objectId","in":"path","schema":{"type":"string"},"description":"Gamertag of the player.Underlying objectId type is integer in format int64.","required":true,"x-beamable-object-id":{"type":"integer","format":"int64"}}],"security":[{}]},"parameters":[{"name":"X-BEAM-SCOPE","in":"header","schema":{"type":"string"},"description":"Customer and project scope. This should be in the form of '<customer-id>.<project-id>'.","required":true},{"name":"X-BEAM-GAMERTAG","in":"header","schema":{"type":"string"},"description":"Override the Gamer Tag of the player. This is generally inferred by the auth token.","required":false}]},"/object/group-users/{objectId}/":{"get":{"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupUser"}}}},"400":{"description":"Bad Request"}},"parameters":[{"name":"objectId","in":"path","schema":{"type":"string"},"description":"Gamertag of the player.Underlying objectId type is integer in format int64.","required":true,"x-beamable-object-id":{"type":"integer","format":"int64"}}],"security":[{}]},"parameters":[{"name":"X-BEAM-SCOPE","in":"header","schema":{"type":"string"},"description":"Customer and project scope. This should be in the form of '<customer-id>.<project-id>'.","required":true},{"name":"X-BEAM-GAMERTAG","in":"header","schema":{"type":"string"},"description":"Override the Gamer Tag of the player. This is generally inferred by the auth token.","required":false}]}},"components":{"schemas":{"GroupCreate":{"properties":{"name":{"type":"string"},"enrollmentType":{"type":"string"},"tag":{"type":"string"},"requirement":{"type":"integer","format":"int64"},"clientData":{"type":"string"},"scores":{"type":"array","items":{"$ref":"#/components/schemas/GroupScoreBinding"}},"time":{"type":"integer","format":"int64","x-beamable-date-format":"unix","description":"Milliseconds since midnight, January 1, 1970 UTC"},"type":{"$ref":"#/components/schemas/GroupType"},"maxSize":{"type":"integer","format":"int32"},"group":{"type":"integer","format":"int64"}},"additionalProperties":false,"title":"Group Create","type":"object","required":["name","enrollmentType","requirement","maxSize","type"]},"DonationEntry":{"type":"object","additionalProperties":false,"properties":{"playerId":{"type":"integer","format":"int64"},"amount":{"type":"integer","format":"int64"},"time":{"type":"integer","format":"int64"},"claimed":{"type":"boolean"}},"required":["playerId","amount","time"]},"GroupType":{"type":"string","enum":["guild","subgroup"]},"Member":{"type":"object","additionalProperties":false,"properties":{"canDemote":{"type":"boolean"},"canKick":{"type":"boolean"},"role":{"type":"string"},"gamerTag":{"type":"integer","format":"int64"},"canPromote":{"type":"boolean"},"scores":{"type":"array","items":{"$ref":"#/components/schemas/GroupScoreBinding"}}},"required":["gamerTag","role"]},"InFlightMessage":{"type":"object","additionalProperties":false,"properties":{"method":{"type":"string"},"body":{"type":"string"},"path":{"type":"string"},"gamerTag":{"type":"integer","format":"int64"},"limitFailureRetries":{"type":"boolean"},"shard":{"type":"string"},"service":{"type":"string"},"id":{"type":"string"}},"required":["service","id","method","path","body"]},"GroupMembershipResponse":{"properties":{"gamerTag":{"type":"integer","format":"int64"},"member":{"type":"boolean"},"type":{"$ref":"#/components/schemas/GroupType"},"subGroups":{"type":"array","items":{"type":"integer","format":"int64"}},"group":{"$ref":"#/components/schemas/GroupMetaData"}},"additionalProperties":false,"title":"Group Membership Response","type":"object","required":["group","member","type","subGroups"]},"GroupRole":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"permissions":{"type":"array","items":{"type":"string"}}},"required":["name","permissions"]},"AvailabilityResponse":{"properties":{"name":{"type":"boolean"},"tag":{"type":"boolean"}},"additionalProperties":false,"title":"Availability Response","type":"object","required":["name","tag"]},"DonationRequest":{"type":"object","additionalProperties":false,"properties":{"timeRequested":{"type":"integer","format":"int64"},"progress":{"type":"array","items":{"$ref":"#/components/schemas/DonationEntry"}},"satisfied":{"type":"boolean"},"playerId":{"type":"integer","format":"int64"},"currency":{"$ref":"#/components/schemas/Currency"}},"required":["playerId","currency","timeRequested","progress","satisfied"]},"GroupCreateResponse":{"properties":{"group":{"$ref":"#/components/schemas/GroupMetaData"}},"additionalProperties":false,"title":"Group Create Response","type":"object","required":["group"]},"GroupSearchResponse":{"properties":{"groups":{"type":"array","items":{"$ref":"#/components/schemas/Group"}}},"additionalProperties":false,"title":"Group Search Response","type":"object","required":["groups"]},"GroupUserMember":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"integer","format":"int64"},"subGroups":{"type":"array","items":{"$ref":"#/components/schemas/GroupUserMember"}},"joined":{"type":"integer","format":"int64"}},"required":["id","subGroups"]},"GroupMemberInfo":{"type":"object","additionalProperties":false,"properties":{"guild":{"type":"array","items":{"$ref":"#/components/schemas/GroupUserMember"}},"subgroup":{"type":"array","items":{"$ref":"#/components/schemas/GroupUserMember"}}}},"CurrencyProperty":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"value":{"type":"string"}},"required":["name","value"]},"Group":{"type":"object","additionalProperties":false,"properties":{"inFlight":{"type":"array","items":{"$ref":"#/components/schemas/InFlightMessage"}},"name":{"type":"string"},"enrollmentType":{"type":"string"},"donations":{"type":"array","items":{"$ref":"#/components/schemas/DonationRequest"}},"freeSlots":{"type":"integer","format":"int32"},"maybeDonations":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/DonationRequest"}},"tag":{"type":"string"},"canUpdateMOTD":{"type":"boolean"},"shard":{"type":"string"},"canUpdateSlogan":{"type":"boolean"},"leader":{"type":"integer","format":"int64"},"slogan":{"type":"string"},"requirement":{"type":"integer","format":"int64"},"motd":{"type":"string"},"version":{"type":"integer","format":"int32"},"id":{"type":"integer","format":"int64"},"clientData":{"type":"string"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/GroupRole"}},"scores":{"type":"object","additionalProperties":{"type":"string"}},"canUpdateEnrollment":{"type":"boolean"},"members":{"type":"array","items":{"$ref":"#/components/schemas/Member"}},"canDisband":{"type":"boolean"},"type":{"$ref":"#/components/schemas/GroupType"},"maxSize":{"type":"integer","format":"int32"},"subGroups":{"type":"array","items":{"$ref":"#/components/schemas/Group"}},"created":{"type":"integer","format":"int64","x-beamable-date-format":"unix","description":"Milliseconds since midnight, January 1, 1970 UTC"}},"required":["id","name","slogan","motd","enrollmentType","requirement","maxSize","members","subGroups","created","type","freeSlots","scores","leader"]},"Currency":{"type":"object","additionalProperties":false,"properties":{"updatedAt":{"type":"integer","format":"int64"},"amount":{"type":"integer","format":"int64"},"id":{"type":"string"},"properties":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyProperty"}},"proxy":{"$ref":"#/components/schemas/FederationInfo"}},"required":["id","amount"]},"GroupMembershipRequest":{"properties":{"successor":{"type":"integer","format":"int64"},"score":{"type":"integer","format":"int64"},"subGroup":{"type":"integer","format":"int64"},"type":{"$ref":"#/components/schemas/GroupType"},"group":{"type":"integer","format":"int64"}},"additionalProperties":false,"title":"Group Membership Request","type":"object","required":["group","type"]},"GroupScoreBinding":{"type":"object","additionalProperties":false,"properties":{"board":{"type":"string"},"derivatives":{"type":"array","items":{"type":"string"}},"score":{"type":"integer","format":"int64"}},"required":["board","derivatives","score"]},"OptionalJsonNodeWrapper":{"type":"object","additionalProperties":false,"x-beamable-json-object":true,"properties":{"node":{"type":"string"}}},"AvailabilityRequest":{"properties":{"name":{"type":"string"},"tag":{"type":"string"},"type":{"$ref":"#/components/schemas/GroupType"},"subGroup":{"type":"boolean"}},"additionalProperties":false,"title":"Availability Request","type":"object","required":["type"]},"GroupSearchRequest":{"properties":{"name":{"type":"string"},"scoreMin":{"type":"integer","format":"int64"},"sortField":{"type":"string"},"userScore":{"type":"integer","format":"int64"},"hasSlots":{"type":"boolean"},"enrollmentTypes":{"type":"string"},"offset":{"type":"integer","format":"int32"},"scoreMax":{"type":"integer","format":"int64"},"subGroup":{"type":"boolean"},"sortValue":{"type":"integer","format":"int32"},"type":{"$ref":"#/components/schemas/GroupType"},"limit":{"type":"integer","format":"int32"}},"additionalProperties":false,"title":"Group Search Request","type":"object","required":["type"]},"GroupMetaData":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"tag":{"type":"string"}},"required":["id"]},"GroupUser":{"properties":{"inFlight":{"type":"array","items":{"$ref":"#/components/schemas/InFlightMessage"}},"gamerTag":{"type":"integer","format":"int64"},"allGroups":{"type":"array","items":{"$ref":"#/components/schemas/GroupUserMember"}},"updated":{"type":"integer","format":"int64","x-beamable-date-format":"unix","description":"Milliseconds since midnight, January 1, 1970 UTC"},"member":{"$ref":"#/components/schemas/GroupMemberInfo"},"scores":{"type":"array","items":{"$ref":"#/components/schemas/GroupScoreBinding"}}},"additionalProperties":false,"title":"Group User","type":"object","required":["gamerTag","updated","member","allGroups"]},"FederationInfo":{"type":"object","additionalProperties":false,"properties":{"service":{"type":"string"},"namespace":{"type":"string"},"settings":{"$ref":"#/components/schemas/OptionalJsonNodeWrapper"}},"required":["service","namespace"]}},"securitySchemes":{"server":{"type":"apiKey","name":"X-DE-SIGNATURE","in":"header","description":"Signed Request authentication using project secret key."},"user":{"type":"http","description":"Bearer authentication with a player access token in the Authorization header.","scheme":"bearer","bearerFormat":"Bearer <Access Token>"}}},"security":[],"externalDocs":{"description":"Beamable Documentation","url":"https://docs.beamable.com"},"openapi":"3.0.2"}