Custom fields
SaaS: Custom fields (1.0.1)
Download OpenAPI specification:Download
API for interacting with SaaS Custom fields.
Update custom field values
Modifies one or more custom field values for the given resource.
Authorizations:
Request Body schema: application/merge-patch+json
id required | string The unique ID of the resource. | ||||||||
saasCategory required | string
The category of the custom field. | ||||||||
required | Array of objects (Custom Field Object) The values of custom fields. | ||||||||
Array
|
Responses
Request samples
- Payload
{- "id": "483c67cf-e247-4a82-bef7-b86a29560788",
- "saasCategory": "Application",
- "customFields": [
- {
- "name": "color",
- "value": "string",
- "dataType": "string",
- "currencyCode": "EUR"
}
]
}
Response samples
- 200
- 400
- 500
{- "tenantId": "2f86b198-04f3-4770-ad08-b32518206da0",
- "saasCategory": "User",
- "objectID": "483c67cf-e247-4a82-bef7-b86a29560788",
- "customFields": [
- {
- "name": "color",
- "value": "string",
- "dataType": "string",
- "currencyCode": "EUR"
}
], - "requesterId": "483c67cf-e247-4a82-bef7-b86a29560788"
}
Get custom fields
Returns a collection of custom fields.
Authorizations:
query Parameters
filter | string Example: filter=?filter='SaaSCategory -eq Application' For more information on the available operators and which data types those operators work on, see Filter API call results. |
page_number | integer <int32> Default: 1 The page number. |
page_size | integer <int32> Default: 100 The maximum number of items in the response. |
sort | string Example: sort=?sort=field1:asc For more information on sorting capability and examples, see Sort API call results. |
Responses
Response samples
- 200
- 400
- 500
{- "pagination": {
- "page_size": 100,
- "page_number": 1,
- "total_pages": 1,
- "total_items": 1
}, - "items": [
- {
- "id": "2f86b198-04f3-4770-ad08-b32518206da0",
- "dataType": "string",
- "predefinedValues": {
- "0": "blue",
- "1": "red",
- "2": "yellow"
}, - "saasCategory": "saas-users",
- "defaultValue": "blue",
- "fieldName": "color",
- "isCurrency": true
}
]
}