Developer DocumentationLegacy APISOAP APICall DefinitionsMetadata CallsOverview

Metadata calls are used to facilitate developer access to the application without requiring login to the user interface by providing field names, data types, character limits, etc.

DescribeCvObject

Usage

Use the DescribeCvObject to get metadata associated with your account CvObjects.

General Syntax

DescribeCvObjectResultArray = cventapi.DescribeCvObject (CvObjectTypeArray ObjectTypes)

Input

NameTypeDescription
ObjectTypesCvObject Type ArrayAn array of the objects you want described.

Output

NameTypeDescription
NameStringName of the object. This is the same string that was passed in as the CvObjectType parameter.
CreatableBooleanIndicates whether a Create call can be made (True) or not (False) for this object.
UpdateableBooleanIndicates whether an Update call can be made (True) or not (False) for this object.
DeletableBooleanIndicates whether a Delete call can be made (True) or not (False) for this object.
ReplicateableBooleanIndicates whether a GetUpdated call can be made (True) or not (False) for this object.
RetrieveableBooleanIndicates whether a Retrieve call can be made (True) or not (False) for this object.
SearchableBooleanIndicates whether a Search call can be made (True) or not (False) for this object.
FieldsFieldGives field level data about the object. The field data includes the following information: Name: The field name. DataType: The data type of the field. MaxLength: The maximum length of the field. This property is only used for string type fields. Searchable: Indicates if the field can be used in a Search call. Required: Indicates if the field is required for a Create call. ReadOnly: Indicates if the field can be updated in an Update call or specified in a Create call. DefaultValue: Gives the default value of the field for a Create or Update call, if no value is supplied. DefaultSerachValue: Gives the default value for a Search call if no specific filter for this field is defined.
CustomFieldFieldGives field level data about the object. The field data includes the following information: ID: The ID of the custom field. Name: The custom field name. Category: The category of the custom field. FieldType: Indicates the field type. Format: The format of the custom field. SetOrder: The order of the custom field. AnswerText: The answer text of the custom field.

DescribeGlobal

Usage

Use the DescribeGlobal to get the API settings for your account.

General Syntax

DescribeGlobalResult = cventapi.DescribeGlobal ()

Input

This API call takes no input.

Output

NameTypeDescription
MaxAPICallsIntegerMaximum number of API calls that can be made by your organization within a 24-hour period (midnight to midnight) Eastern Time (ET).
CurrentAPICallsIntegerCurrent number of API calls made by your organization in the current 24-hour period (midnight to midnight) Eastern Time (ET).
MaxBatchSizeIntegerThe maximum number of records that can be impacted by a Create, Update, or Delete call.
MaxRecordSetIntegerThe maximum number of records that can be impacted by a Create, Update, or Delete call.
CvObjectTypesString ArrayA list of object types valid for your account.
Last updated on