User Requests

A UserRequest is an operation that allows anonymous users to place a request for access on the login screen to the site administrator.

List User Requests

SDK Method

userrequest.List()

Return Object

[]*UserRequest

Authorization Requirement

Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.

Additional Arguments

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    user_request "github.com/Files-com/files-sdk-go/v3/userrequest"
)

userRequestIterator, err := user_request.List(files_sdk.UserRequestListParams{})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

for userRequestIterator.Next() {
    userRequest := userRequestIterator.userRequest()
}
err = userRequestIterator.Err()
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

Show User Request

SDK Method

userrequest.Find()

Return Object

UserRequest

Authorization Requirement

Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.

UserRequestFindParams Fields

FieldDescription
Id
int64
Required		User Request ID.

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    user_request "github.com/Files-com/files-sdk-go/v3/userrequest"
)

userRequest, err := user_request.Find(files_sdk.UserRequestFindParams{Id: 1})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

Create User Request

SDK Method

userrequest.Create()

Return Object

UserRequest

Authorization Requirement

No authentication required; you may call this endpoint without a key or session.

UserRequestCreateParams Fields

FieldDescription
Name
string
Required		Name of user requested
Email
string
Required		Email of user requested
Details
string
Required		Details of the user request
Company
string		Company of the user requested

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    user_request "github.com/Files-com/files-sdk-go/v3/userrequest"
)

userRequest, err := user_request.Create(files_sdk.UserRequestCreateParams{
  Name: "name",
  Email: "email",
  Details: "details"
})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

Delete User Request

SDK Method

userrequest.Delete()

Return Object

No return value.

Authorization Requirement

Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.

UserRequestDeleteParams Fields

FieldDescription
Id
int64
Required		User Request ID.

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    user_request "github.com/Files-com/files-sdk-go/v3/userrequest"
)

err := user_request.Delete(files_sdk.UserRequestDeleteParams{Id: 1})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

The UserRequest Object

Some of the methods above return a UserRequest object. The attributes of this object are listed below.

AttributeDescription
Id
int64		ID
Name
string		User's full name
Email
email		User email address
Details
string		Details of the user's request
Company
string		User's company name