CZERTAINLY Attribute API (2.13.1)
Download OpenAPI specification:Download
REST API for managing Custom attributes and global metadata in the platform
Response samples
- 200
- 400
- 403
- 404
Content type
application/json
{- "uuid": "string",
- "name": "string",
- "contentType": "string",
- "description": "string",
- "enabled": true,
- "type": "data",
- "label": "Attribute Name",
- "required": true,
- "visible": true,
- "group": "requiredAttributes",
- "readOnly": false,
- "list": false,
- "multiSelect": false,
- "content": [
- {
- "reference": "string",
- "data": true
}
], - "resources": [
- "NONE"
]
}Edit Custom Attribute
path Parameters
| uuid required | string Attribute UUID |
Request Body schema: application/jsonrequired
| description | string Attribute description |
| label required | string Friendly name of the the Attribute |
| visible | boolean Default: true Boolean determining if the Attribute is visible and can be displayed, otherwise it should be hidden to the user. |
| group | string Group of the Attribute, used for the logical grouping of the Attribute |
| required | boolean Default: false Boolean determining if the Attribute is required. If true, the Attribute must be provided. |
| readOnly | boolean Default: false Boolean determining if the Attribute is read only. If true, the Attribute content cannot be changed. |
| list | boolean Default: false Boolean determining if the Attribute contains list of values in the content |
| multiSelect | boolean Default: false Boolean determining if the Attribute can have multiple values |
Array of BooleanAttributeContent (object) or CodeBlockAttributeContent (object) or CredentialAttributeContent (object) or DateAttributeContent (object) or DateTimeAttributeContent (object) or FileAttributeContent (object) or FloatAttributeContent (object) or IntegerAttributeContent (object) or ObjectAttributeContent (object) or SecretAttributeContent (object) or StringAttributeContent (object) or TextAttributeContent (object) or TimeAttributeContent (object) (BaseAttributeContentDto) Predefined content for the attribute if needed. The content of the Attribute must satisfy the type | |
| resources | Array of strings (Resource) Items Enum: "NONE" "dashboard" "settings" "auditLogs" "credentials" "connectors" "attributes" "jobs" "notificationInstances" "users" "roles" "acmeAccounts" "acmeProfiles" "scepProfiles" "cmpProfiles" "authorities" "raProfiles" "certificates" "certificateRequests" "groups" "complianceProfiles" "discoveries" "entities" "locations" "tokenProfiles" "tokens" "keys" "approvalProfiles" "approvals" "rules" "actions" "triggers" List of resource to be associated with the custom attribute |
Responses
Request samples
- Payload
Content type
application/json
{- "description": "string",
- "label": "Attribute Name",
- "visible": true,
- "group": "requiredAttributes",
- "required": false,
- "readOnly": false,
- "list": false,
- "multiSelect": false,
- "content": [
- {
- "reference": "string",
- "data": true
}
], - "resources": [
- "NONE"
]
}Response samples
- 200
- 400
- 403
- 404
Content type
application/json
{- "uuid": "string",
- "name": "string",
- "contentType": "string",
- "description": "string",
- "enabled": true,
- "type": "data",
- "label": "Attribute Name",
- "required": true,
- "visible": true,
- "group": "requiredAttributes",
- "readOnly": false,
- "list": false,
- "multiSelect": false,
- "content": [
- {
- "reference": "string",
- "data": true
}
], - "resources": [
- "NONE"
]
}List Custom Attributes
query Parameters
| attributeContentType | string (AttributeContentType) Enum: "string" "text" "integer" "boolean" "float" "date" "time" "datetime" "secret" "file" "credential" "codeblock" "object" Type of the attribute content. |
Responses
Response samples
- 200
- 400
- 403
- 404
Content type
application/json
[- {
- "uuid": "string",
- "name": "string",
- "contentType": "string",
- "description": "string",
- "enabled": true,
- "resources": [
- "NONE"
]
}
]Create Custom Attribute
Request Body schema: application/jsonrequired
| name required | string Name of the Attribute |
| contentType required | string (AttributeContentType) Enum: "string" "text" "integer" "boolean" "float" "date" "time" "datetime" "secret" "file" "credential" "codeblock" "object" Type of the attribute content. |
| description | string Attribute description |
| label required | string Friendly name of the the Attribute |
| visible | boolean Default: true Boolean determining if the Attribute is visible and can be displayed, otherwise it should be hidden to the user. |
| group | string Group of the Attribute, used for the logical grouping of the Attribute |
| required | boolean Default: false Boolean determining if the Attribute is required. If true, the Attribute must be provided. |
| readOnly | boolean Default: false Boolean determining if the Attribute is read only. If true, the Attribute content cannot be changed. |
| list | boolean Default: false Boolean determining if the Attribute contains list of values in the content |
| multiSelect | boolean Default: false Boolean determining if the Attribute can have multiple values |
Array of BooleanAttributeContent (object) or CodeBlockAttributeContent (object) or CredentialAttributeContent (object) or DateAttributeContent (object) or DateTimeAttributeContent (object) or FileAttributeContent (object) or FloatAttributeContent (object) or IntegerAttributeContent (object) or ObjectAttributeContent (object) or SecretAttributeContent (object) or StringAttributeContent (object) or TextAttributeContent (object) or TimeAttributeContent (object) (BaseAttributeContentDto) Predefined content for the attribute if needed. The content of the Attribute must satisfy the type | |
| resources | Array of strings (Resource) Items Enum: "NONE" "dashboard" "settings" "auditLogs" "credentials" "connectors" "attributes" "jobs" "notificationInstances" "users" "roles" "acmeAccounts" "acmeProfiles" "scepProfiles" "cmpProfiles" "authorities" "raProfiles" "certificates" "certificateRequests" "groups" "complianceProfiles" "discoveries" "entities" "locations" "tokenProfiles" "tokens" "keys" "approvalProfiles" "approvals" "rules" "actions" "triggers" List of resource to be associated with the custom attribute |
Responses
Request samples
- Payload
Content type
application/json
{- "name": "string",
- "contentType": "string",
- "description": "string",
- "label": "Attribute Name",
- "visible": true,
- "group": "requiredAttributes",
- "required": false,
- "readOnly": false,
- "list": false,
- "multiSelect": false,
- "content": [
- {
- "reference": "string",
- "data": true
}
], - "resources": [
- "NONE"
]
}Response samples
- 201
- 400
- 403
- 404
Content type
application/json
{- "uuid": "string"
}Delete multiple Custom Attributes
Request Body schema: application/jsonrequired
Attribute UUIDs
Array
string
Responses
Request samples
- Payload
Content type
application/json
[- "c2f685d4-6a3e-11ec-90d6-0242ac120003",
- "b9b09548-a97c-4c6a-a06a-e4ee6fc2da98"
]Response samples
- 400
- 403
- 404
Content type
application/json
{- "message": "Error message"
}Associate Custom Attribute to Resource
path Parameters
| uuid required | string Custom Attribute UUID |
Request Body schema: application/jsonrequired
List of Resources
Array
string
Responses
Request samples
- Payload
Content type
application/json
[- "raProfiles",
- "authorities"
]Response samples
- 400
- 403
- 404
Content type
application/json
{- "message": "Error message"
}Delete Value of a Custom Attribute for a Resource
path Parameters
| resourceName required | string (Resource) Enum: "NONE" "dashboard" "settings" "auditLogs" "credentials" "connectors" "attributes" "jobs" "notificationInstances" "users" "roles" "acmeAccounts" "acmeProfiles" "scepProfiles" "cmpProfiles" "authorities" "raProfiles" "certificates" "certificateRequests" "groups" "complianceProfiles" "discoveries" "entities" "locations" "tokenProfiles" "tokens" "keys" "approvalProfiles" "approvals" "rules" "actions" "triggers" Resource Type |
| objectUuid required | string Object UUID |
| attributeUuid required | string Custom Attribute UUID |
Responses
Response samples
- 200
- 400
- 403
- 404
Content type
application/json
[- {
- "uuid": "166b5cf52-63f2-11ec-90d6-0242ac120003",
- "name": "Attribute",
- "label": "Attribute Name",
- "type": "data",
- "contentType": "string",
- "content": [
- {
- "reference": "string",
- "data": true
}
]
}
]Update Value of a Custom Attribute for a Resource
path Parameters
| resourceName required | string (Resource) Enum: "NONE" "dashboard" "settings" "auditLogs" "credentials" "connectors" "attributes" "jobs" "notificationInstances" "users" "roles" "acmeAccounts" "acmeProfiles" "scepProfiles" "cmpProfiles" "authorities" "raProfiles" "certificates" "certificateRequests" "groups" "complianceProfiles" "discoveries" "entities" "locations" "tokenProfiles" "tokens" "keys" "approvalProfiles" "approvals" "rules" "actions" "triggers" Resource Type |
| objectUuid required | string Object UUID |
| attributeUuid required | string Custom Attribute UUID |
Request Body schema: application/jsonrequired
Array
One of
| reference | string Content Reference |
| data required | object Boolean attribute value |
Responses
Request samples
- Payload
Content type
application/json
[- {
- "reference": "string",
- "data": true
}
]Response samples
- 200
- 400
- 403
- 404
Content type
application/json
[- {
- "uuid": "166b5cf52-63f2-11ec-90d6-0242ac120003",
- "name": "Attribute",
- "label": "Attribute Name",
- "type": "data",
- "contentType": "string",
- "content": [
- {
- "reference": "string",
- "data": true
}
]
}
]Enable multiple Custom Attributes
Request Body schema: application/jsonrequired
Attribute UUIDs
Array
string
Responses
Request samples
- Payload
Content type
application/json
[- "c2f685d4-6a3e-11ec-90d6-0242ac120003",
- "b9b09548-a97c-4c6a-a06a-e4ee6fc2da98"
]Response samples
- 400
- 403
- 404
Content type
application/json
{- "message": "Error message"
}Disable multiple Custom Attributes
Request Body schema: application/jsonrequired
Attribute UUIDs
Array
string
Responses
Request samples
- Payload
Content type
application/json
[- "c2f685d4-6a3e-11ec-90d6-0242ac120003",
- "b9b09548-a97c-4c6a-a06a-e4ee6fc2da98"
]Response samples
- 400
- 403
- 404
Content type
application/json
{- "message": "Error message"
}Get Custom Attributes for a resource
path Parameters
| resource required | string (Resource) Enum: "NONE" "dashboard" "settings" "auditLogs" "credentials" "connectors" "attributes" "jobs" "notificationInstances" "users" "roles" "acmeAccounts" "acmeProfiles" "scepProfiles" "cmpProfiles" "authorities" "raProfiles" "certificates" "certificateRequests" "groups" "complianceProfiles" "discoveries" "entities" "locations" "tokenProfiles" "tokens" "keys" "approvalProfiles" "approvals" "rules" "actions" "triggers" Resource Name |
Responses
Response samples
- 200
- 400
- 403
- 404
Content type
application/json
[- {
- "uuid": "166b5cf52-63f2-11ec-90d6-0242ac120003",
- "name": "Attribute",
- "description": "string",
- "content": [
- {
- "reference": "string",
- "data": true
}
], - "type": "data",
- "contentType": "string",
- "properties": {
- "label": "Attribute Name",
- "visible": true,
- "group": "requiredAttributes",
- "required": false,
- "readOnly": false,
- "list": false,
- "multiSelect": false
}
}
]Response samples
- 200
- 400
- 403
- 404
Content type
application/json
{- "uuid": "string",
- "name": "string",
- "contentType": "string",
- "description": "string",
- "enabled": true,
- "type": "data",
- "label": "Attribute Name",
- "visible": true,
- "group": "requiredAttributes"
}Edit Global Metadata
path Parameters
| uuid required | string Global Metadata UUID |
Request Body schema: application/jsonrequired
| description | string Attribute description |
| label required | string Friendly name of the the Attribute |
| visible | boolean Default: true Boolean determining if the Attribute is visible and can be displayed, otherwise it should be hidden to the user. |
| group | string Group of the Attribute, used for the logical grouping of the Attribute |
Responses
Request samples
- Payload
Content type
application/json
{- "description": "string",
- "label": "Attribute Name",
- "visible": true,
- "group": "requiredAttributes"
}Response samples
- 200
- 400
- 403
- 404
Content type
application/json
{- "uuid": "string",
- "name": "string",
- "contentType": "string",
- "description": "string",
- "enabled": true,
- "type": "data",
- "label": "Attribute Name",
- "visible": true,
- "group": "requiredAttributes"
}Create Global Metadata
Request Body schema: application/jsonrequired
| name required | string Name of the Attribute |
| contentType required | string (AttributeContentType) Enum: "string" "text" "integer" "boolean" "float" "date" "time" "datetime" "secret" "file" "credential" "codeblock" "object" Type of the attribute content. |
| description | string Attribute description |
| label required | string Friendly name of the the Attribute |
| visible | boolean Default: true Boolean determining if the Attribute is visible and can be displayed, otherwise it should be hidden to the user. |
| group | string Group of the Attribute, used for the logical grouping of the Attribute |
Responses
Request samples
- Payload
Content type
application/json
{- "name": "string",
- "contentType": "string",
- "description": "string",
- "label": "Attribute Name",
- "visible": true,
- "group": "requiredAttributes"
}Response samples
- 201
- 400
- 403
- 404
Content type
application/json
{- "uuid": "string"
}Delete multiple Global Metadata
Request Body schema: application/jsonrequired
Global Metadata UUIDs
Array
string
Responses
Request samples
- Payload
Content type
application/json
[- "c2f685d4-6a3e-11ec-90d6-0242ac120003",
- "b9b09548-a97c-4c6a-a06a-e4ee6fc2da98"
]Response samples
- 400
- 403
- 404
Content type
application/json
{- "message": "Error message"
}Promote Connector Metadata to Global Metadata
Request Body schema: application/jsonrequired
| uuid required | string Metadata UUID |
| connectorUuid required | string Connector UUID |
Responses
Request samples
- Payload
Content type
application/json
{- "uuid": "string",
- "connectorUuid": "string"
}Response samples
- 204
- 400
- 403
- 404
Content type
application/json
{- "uuid": "string",
- "name": "string",
- "contentType": "string",
- "description": "string",
- "enabled": true,
- "type": "data",
- "label": "Attribute Name",
- "visible": true,
- "group": "requiredAttributes"
}