Jump to

• Request
• Response

Get a list of user Custom Fields.

get

/learn.rest/v1/learnCenters/{learnCenterId}/userCustomFields

Request

Path Parameters

• learnCenterId(required): number
  Unique identifier of a Learn Center.

Query Parameters

• limit: integer
  Specify how many items should be returned in a payload. Must be lower than server default limit size.
• offset: integer
  Specify the starting point of the response.

  Default Value: 0
• totalResults: boolean
  If set to true, the payload includes the total number of rows that satisfies the request. Use of this parameter determines if the last link is displayed for a pageable collection.

Back to Top

Response

Supported Media Types

• application/xml
• application/json

200 Response

The user custom fields collection is fetched.

Body ()

Root Schema : UserCustomFieldsResponse

Type: object

Show Source

• count: number
  Example: 100
• hasMore: boolean
  Example: false
• items: array items
• limit: number
  Example: 100
• links: array links

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/UserCustomFieldResponse"
            }
        },
        "limit":{
            "type":"number",
            "example":100
        },
        "count":{
            "type":"number",
            "example":100
        },
        "hasMore":{
            "type":"boolean",
            "example":false
        },
        "links":{
            "type":"array",
            "items":{
                "properties":{
                    "rel":{
                        "type":"string"
                    },
                    "href":{
                        "type":"string"
                    }
                }
            },
            "example":[
                {
                    "rel":"canonical",
                    "href":"{url}/learn.rest/v1/learnCenters/178409/userCustomFields"
                }
            ]
        }
    }
}

Nested Schema : items

Type: array

Show Source

• Array of: object User Custom Fields

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/UserCustomFieldResponse"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "properties":{
            "rel":{
                "type":"string"
            },
            "href":{
                "type":"string"
            }
        }
    },
    "example":[
        {
            "rel":"canonical",
            "href":"{url}/learn.rest/v1/learnCenters/178409/userCustomFields"
        }
    ]
}

Example:

[
    {
        "rel":"canonical",
        "href":"{url}/learn.rest/v1/learnCenters/178409/userCustomFields"
    }
]

Nested Schema : User Custom Fields

Type: object

Show Source

• defaultValue: string
  Example: n/a
• elementOptions: array elementOptions
• elementShowSelectOne: boolean
  Example: false
• elementType: string
  Example: radio
• id: number
  Example: 123
• learnCenter: object learnCenter
• learnCenterId: string
  Example: 178409
• links: object UserCustomFieldLink
• name: string
  Example: User Custom Field 1
• sharedFlag: boolean
  Example: true
• status: string
  Allowed Values: [ "active", "inactive" ]

  Example: active

{
    "type":"object",
    "properties":{
        "id":{
            "type":"number",
            "example":123
        },
        "learnCenterId":{
            "type":"string",
            "example":178409
        },
        "learnCenter":{
            "type":"object",
            "properties":{
                "items":{
                    "$ref":"#/definitions/LearnCenterLink"
                }
            }
        },
        "name":{
            "type":"string",
            "example":"User Custom Field 1"
        },
        "defaultValue":{
            "type":"string",
            "example":"n/a"
        },
        "elementType":{
            "type":"string",
            "example":"radio"
        },
        "elementShowSelectOne":{
            "type":"boolean",
            "example":false
        },
        "elementOptions":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/UserCustomFieldElementOptionsLink"
            }
        },
        "sharedFlag":{
            "type":"boolean",
            "example":true
        },
        "status":{
            "type":"string",
            "enum":[
                "active",
                "inactive"
            ],
            "example":"active"
        },
        "links":{
            "$ref":"#/definitions/UserCustomFieldLink"
        }
    },
    "xml":{
        "name":"User Custom Fields"
    }
}

Nested Schema : elementOptions

Type: array

Show Source

• Array of: object UserCustomFieldElementOptionsLink

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/UserCustomFieldElementOptionsLink"
    }
}

Nested Schema : learnCenter

Type: object

Show Source

• items: object LearnCenterLink

{
    "type":"object",
    "properties":{
        "items":{
            "$ref":"#/definitions/LearnCenterLink"
        }
    }
}

Nested Schema : UserCustomFieldLink

Type: object

Show Source

• href: string
• rel: string

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    },
    "example":{
        "rel":"canonical",
        "href":"https://{url}/learn.rest/v1/learnCenters/178409/userCustomFields/102"
    }
}

Example:

{
    "rel":"canonical",
    "href":"https://{url}/learn.rest/v1/learnCenters/178409/userCustomFields/102"
}

Nested Schema : UserCustomFieldElementOptionsLink

Type: object

Show Source

• isDefault: boolean
  Example: false
• value: string
  Example: first value

{
    "type":"object",
    "properties":{
        "value":{
            "type":"string",
            "example":"first value"
        },
        "isDefault":{
            "type":"boolean",
            "example":false
        }
    }
}

Nested Schema : LearnCenterLink

Type: object

Show Source

• href: string
  Example: {url}/learn.rest/v1/learnCenters/178409
• rel: string
  Example: canonical

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "example":"canonical"
        },
        "href":{
            "type":"string",
            "example":"{url}/learn.rest/v1/learnCenters/178409"
        }
    }
}

Nested Schema : items

Type: object

Show Source

• href: string
• rel: string

{
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    }
}

401 Response

Authentication refused for provided credentials or token invalid.

Headers

• WWW_Authenticate: string

500 Response

Internal server error.

Back to Top