Requires the role: | manager |
POST | /users/{Id}/roles/assign |
---|
import Foundation
import ServiceStack
public class AssignRolesRequest : PostOperationUnTenanted<AssignRolesResponse>
{
public var id:String?
public var roles:[String] = []
required public init(){ super.init() }
private enum CodingKeys : String, CodingKey {
case id
case roles
}
required public init(from decoder: Decoder) throws {
try super.init(from: decoder)
let container = try decoder.container(keyedBy: CodingKeys.self)
id = try container.decodeIfPresent(String.self, forKey: .id)
roles = try container.decodeIfPresent([String].self, forKey: .roles) ?? []
}
public override func encode(to encoder: Encoder) throws {
try super.encode(to: encoder)
var container = encoder.container(keyedBy: CodingKeys.self)
if id != nil { try container.encode(id, forKey: .id) }
if roles.count > 0 { try container.encode(roles, forKey: .roles) }
}
}
public class PostOperationUnTenanted<TResponse : Codable> : IPost, Codable
{
required public init(){}
}
public class AssignRolesResponse : Codable
{
public var responseStatus:ResponseStatus?
public var userAccount:UserAccount?
required public init(){}
}
public class UserAccount : IIdentifiableResource, Codable
{
public var name:UserAccountName?
public var displayName:String?
public var email:String?
public var roles:[String] = []
public var status:AccountStatus?
public var defaultOrganisationId:String?
public var id:String?
required public init(){}
}
public class UserAccountName : Codable
{
public var firstName:String?
public var lastName:String?
required public init(){}
}
public enum AccountStatus : String, Codable
{
case Shadowed
case Registered
}
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /users/{Id}/roles/assign HTTP/1.1
Host: staging-api.billiecart.com.au
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<AssignRolesRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Infrastructure.Api.Interfaces.ServiceOperations.UserAccounts">
<Id>String</Id>
<Roles xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d2p1:string>String</d2p1:string>
</Roles>
</AssignRolesRequest>
HTTP/1.1 200 OK Content-Type: application/xml Content-Length: length <AssignRolesResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Infrastructure.Api.Interfaces.ServiceOperations.UserAccounts"> <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types"> <d2p1:ErrorCode>String</d2p1:ErrorCode> <d2p1:Message>String</d2p1:Message> <d2p1:StackTrace>String</d2p1:StackTrace> <d2p1:Errors> <d2p1:ResponseError> <d2p1:ErrorCode>String</d2p1:ErrorCode> <d2p1:FieldName>String</d2p1:FieldName> <d2p1:Message>String</d2p1:Message> <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d5p1:KeyValueOfstringstring> <d5p1:Key>String</d5p1:Key> <d5p1:Value>String</d5p1:Value> </d5p1:KeyValueOfstringstring> </d2p1:Meta> </d2p1:ResponseError> </d2p1:Errors> <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d3p1:KeyValueOfstringstring> <d3p1:Key>String</d3p1:Key> <d3p1:Value>String</d3p1:Value> </d3p1:KeyValueOfstringstring> </d2p1:Meta> </ResponseStatus> <UserAccount xmlns:d2p1="http://schemas.datacontract.org/2004/07/Application.Interfaces.Resources"> <d2p1:DefaultOrganisationId>String</d2p1:DefaultOrganisationId> <d2p1:DisplayName>String</d2p1:DisplayName> <d2p1:Email>String</d2p1:Email> <d2p1:Id>String</d2p1:Id> <d2p1:Name> <d2p1:FirstName>String</d2p1:FirstName> <d2p1:LastName>String</d2p1:LastName> </d2p1:Name> <d2p1:Roles xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d3p1:string>String</d3p1:string> </d2p1:Roles> <d2p1:Status>Shadowed</d2p1:Status> </UserAccount> </AssignRolesResponse>