Skip to main content

UserAttributesApi

MethodHTTP requestDescription
createUserAttributeUsingPOSTPOST /api/web/v1/userattributesCreate a user attribute
deleteUserAttributeUsingDELETEDELETE /api/web/v1/userattributes/{id}Delete a user attribute
getUserAttributeUsingGETGET /api/web/v1/userattributes/{id}Get a user attribute
listUserAttributesUsingGETGET /api/web/v1/userattributesList user attributes
modifyUserAttributeUsingPUTPUT /api/web/v1/userattributes/{id}Modify a user attribute

createUserAttributeUsingPOST

UserAttribute createUserAttributeUsingPOST(userAttributeParms)

Create a user attribute

Create a user attribute. Caller requires the USERATTRIBUTES:ADD permission.

Parameters

NameTypeDescriptionNotes
userAttributeParmsUserAttributeParms

Return type

UserAttribute

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

deleteUserAttributeUsingDELETE

deleteUserAttributeUsingDELETE(id)

Delete a user attribute

Delete the specified user attribute. Caller requires the USERATTRIBUTES:REMOVE permission.

Example

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the user attribute to delete.

Return type

null (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

getUserAttributeUsingGET

UserAttribute getUserAttributeUsingGET(id)

Get a user attribute

Get the specified user attribute. Caller requires the USERATTRIBUTES:VIEW permission.

Example

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the user attribute to get.

Return type

UserAttribute

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

listUserAttributesUsingGET

List<UserAttribute> listUserAttributesUsingGET()

List user attributes

List all user attributes defined for the account. Caller requires the USERATTRIBUTES:VIEW permission.

Example

Parameters

This endpoint does not need any parameter.

Return type

List<UserAttribute>

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

modifyUserAttributeUsingPUT

UserAttribute modifyUserAttributeUsingPUT(id, userAttributeParms)

Modify a user attribute

Modify the specified user attribute. Caller requires the USERATTRIBUTES:EDIT permission.

Example

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the user attribute to be modified.
userAttributeParmsUserAttributeParms

Return type

UserAttribute

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-