GET v1/Genre/{genreId}/Article/CustomFields/WithLookups

Finds the custom fields available for articles with a specified genre, and returns all lookup values for the fields. This returns information about the fields that an article of a specified genre is allowed to use - it does not return the values that are set for the article's custom fields.

Roles Allowed

admin, editor

Request Information

URI Parameters

NameDescriptionTypeAdditional information
genreId

integer

Required

Body Parameters

None.

Response Information

Resource Description

HTTP 200 with Custom fields, HTTP 404 if Genre not found

Collection of CustomFieldWithLookups
NameDescriptionTypeAdditional information
CustomFieldLookups

Collection of CustomFieldLookup

None.

CustomFieldID

Unique identifier for the Custom Field

integer

None.

FieldName

The name of the custom field

string

None.

Description

The description of the field

string

None.

IsMultiselect

Can multiple values be specfied for this field

boolean

None.

LimitToLookups

If LimitToLookups is true, users may only set a value that is present in the lookups list.

boolean

None.

CanAddLookup

If CanAddLookup is true, users may add new values to the lookup list. New items must be added to the list before they can be used on an article / media.

boolean

None.

CanRequestLookup

If CanRequestLookup is true, a user can suggest that a value be added to the lookup list, but it will not be available for assignement to an article / media until it has been approved an administrator.

boolean

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "CustomFieldLookups": [
      {
        "CustomFieldLookupID": 1,
        "CustomFieldID": 2,
        "ApprovedBy": "sample string 3",
        "ApprovedDate": "2024-11-21T06:23:34.6263893+00:00",
        "CustomFieldValue": "sample string 4"
      },
      {
        "CustomFieldLookupID": 1,
        "CustomFieldID": 2,
        "ApprovedBy": "sample string 3",
        "ApprovedDate": "2024-11-21T06:23:34.6263893+00:00",
        "CustomFieldValue": "sample string 4"
      }
    ],
    "CustomFieldID": 1,
    "FieldName": "sample string 2",
    "Description": "sample string 3",
    "IsMultiselect": true,
    "LimitToLookups": true,
    "CanAddLookup": true,
    "CanRequestLookup": true
  },
  {
    "CustomFieldLookups": [
      {
        "CustomFieldLookupID": 1,
        "CustomFieldID": 2,
        "ApprovedBy": "sample string 3",
        "ApprovedDate": "2024-11-21T06:23:34.6263893+00:00",
        "CustomFieldValue": "sample string 4"
      },
      {
        "CustomFieldLookupID": 1,
        "CustomFieldID": 2,
        "ApprovedBy": "sample string 3",
        "ApprovedDate": "2024-11-21T06:23:34.6263893+00:00",
        "CustomFieldValue": "sample string 4"
      }
    ],
    "CustomFieldID": 1,
    "FieldName": "sample string 2",
    "Description": "sample string 3",
    "IsMultiselect": true,
    "LimitToLookups": true,
    "CanAddLookup": true,
    "CanRequestLookup": true
  }
]

application/xml, text/xml

Sample:
<ArrayOfCustomFieldWithLookups xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Bondi.Models.V3.ApiDto">
  <CustomFieldWithLookups>
    <CanAddLookup>true</CanAddLookup>
    <CanRequestLookup>true</CanRequestLookup>
    <CustomFieldID>1</CustomFieldID>
    <Description>sample string 3</Description>
    <FieldName>sample string 2</FieldName>
    <IsMultiselect>true</IsMultiselect>
    <LimitToLookups>true</LimitToLookups>
    <CustomFieldLookups>
      <CustomFieldLookup>
        <CustomFieldValue>sample string 4</CustomFieldValue>
        <ApprovedBy>sample string 3</ApprovedBy>
        <ApprovedDate>2024-11-21T06:23:34.6263893+00:00</ApprovedDate>
        <CustomFieldID>2</CustomFieldID>
        <CustomFieldLookupID>1</CustomFieldLookupID>
      </CustomFieldLookup>
      <CustomFieldLookup>
        <CustomFieldValue>sample string 4</CustomFieldValue>
        <ApprovedBy>sample string 3</ApprovedBy>
        <ApprovedDate>2024-11-21T06:23:34.6263893+00:00</ApprovedDate>
        <CustomFieldID>2</CustomFieldID>
        <CustomFieldLookupID>1</CustomFieldLookupID>
      </CustomFieldLookup>
    </CustomFieldLookups>
  </CustomFieldWithLookups>
  <CustomFieldWithLookups>
    <CanAddLookup>true</CanAddLookup>
    <CanRequestLookup>true</CanRequestLookup>
    <CustomFieldID>1</CustomFieldID>
    <Description>sample string 3</Description>
    <FieldName>sample string 2</FieldName>
    <IsMultiselect>true</IsMultiselect>
    <LimitToLookups>true</LimitToLookups>
    <CustomFieldLookups>
      <CustomFieldLookup>
        <CustomFieldValue>sample string 4</CustomFieldValue>
        <ApprovedBy>sample string 3</ApprovedBy>
        <ApprovedDate>2024-11-21T06:23:34.6263893+00:00</ApprovedDate>
        <CustomFieldID>2</CustomFieldID>
        <CustomFieldLookupID>1</CustomFieldLookupID>
      </CustomFieldLookup>
      <CustomFieldLookup>
        <CustomFieldValue>sample string 4</CustomFieldValue>
        <ApprovedBy>sample string 3</ApprovedBy>
        <ApprovedDate>2024-11-21T06:23:34.6263893+00:00</ApprovedDate>
        <CustomFieldID>2</CustomFieldID>
        <CustomFieldLookupID>1</CustomFieldLookupID>
      </CustomFieldLookup>
    </CustomFieldLookups>
  </CustomFieldWithLookups>
</ArrayOfCustomFieldWithLookups>