Greyswift API Endpoints

Endpoints

You may retrieve and modify your company's data by using HTTPS requests on the following endpoints.

Base URL

The base URL for Greyswift's API is https://greyswift.com/api/v3/

The API is organized around REST. It has predictable resource-oriented URLs, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Authentication

Each request should use basic authentication with your Greyswift username and password. This means including the Authorization header with each HTTP request.

Need more help?

Please refer to our examples or contact us.

AssetFormTypes

API	Description
GET AssetFormTypes/GetAllForAsset?assetId={assetId}	Retrieves all asset form types for the given asset. This includes asset form types of that asset that may not have a value.
GET AssetFormTypes?assetId={assetId}&formTypeId={formTypeId}	Retrieves asset form types for the given parameters. All parameters are optional. Asset form types represent a particular asset's overrides of the form types of its asset type.
GET AssetFormTypes?assetFormTypeId={assetFormTypeId}	Retrieves an asset form type by its Id.
PUT AssetFormTypes	Updates an asset form type.

AssetGroups

API	Description
GET AssetGroups/ByLastModifiedDate?beginDate={beginDate}&endDate={endDate}	Retrieves asset groups for the given parameters. All parameters are optional.
GET AssetGroups?parentGroupId={parentGroupId}&take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves asset groups for the given parameters. All parameters are optional.
GET AssetGroups?assetGroupId={assetGroupId}	Retrieves an asset group by its Id.
POST AssetGroups	Creates a new group.
PUT AssetGroups	Updates the given group.
DELETE AssetGroups	Deletes the given group, including its assets.

AssetMeasurementTypes

API	Description
GET AssetMeasurementTypes/GetAllForAsset?assetId={assetId}	Retrieves all asset measurement types for the given asset. This includes asset measurement types of that asset that may not have a value.
GET AssetMeasurementTypes?assetId={assetId}&measurementTypeId={measurementTypeId}	Retrieves asset measurement types for the given parameters. All parameters are optional. Asset measurement types represent a particular asset's overrides of the measurement types of its asset type.
GET AssetMeasurementTypes?assetMeasurementTypeId={assetMeasurementTypeId}	Retrieves an asset measurement type by its Id.
PUT AssetMeasurementTypes	Updates an asset measurement type.

Assets

API	Description
PUT Assets/UpdateLocation	Updates the given asset's location.
PUT Assets/UpdateBarcode	Updates the given asset's barcode.
GET Assets/ByLastModifiedDate?assetTypeId={assetTypeId}&beginDate={beginDate}&endDate={endDate}	Retrieves assets for the given parameters. All parameters are optional.
GET Assets?assetTypeId={assetTypeId}&assetGroupId={assetGroupId}&parentAssetId={parentAssetId}&take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves assets for the given parameters. All parameters are optional.
GET Assets?assetId={assetId}&includeAllAncestors={includeAllAncestors}	Retrieves an asset by its Id.
POST Assets	Creates a new asset.
PUT Assets	Updates the given asset.
DELETE Assets	Deletes the given asset.

AssetTypes

API	Description
GET AssetTypes?take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves asset types for the given parameters. All parameters are optional.
GET AssetTypes?assetTypeId={assetTypeId}	Retrieves an asset type by its Id.
POST AssetTypes	Creates a new asset type.
PUT AssetTypes	Updates the given asset type.
DELETE AssetTypes	Deletes the given asset type, including all assets of that type.

AttachmentCategories

API	Description
GET AttachmentCategories?take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves attachment categories for the given parameters. All parameters are optional.
GET AttachmentCategories?attachmentCategoryId={attachmentCategoryId}	Retrieves an attachment category by its Id.
POST AttachmentCategories	Creates a new attachment category.
PUT AttachmentCategories	Updates the given attachment category.
DELETE AttachmentCategories	Deletes the given attachment category.

Attachments

API	Description
GET Attachments/GetFile?attachmentId={attachmentId}&openInBrowser={openInBrowser}	Retrieves a file stream of an attachment's content.
GET Attachments/GetContent?attachmentId={attachmentId}&startIndex={startIndex}&chunkSize={chunkSize}	Retrieves a specified chunk of an attachment's content.
GET Attachments/ByUploadDate?assetId={assetId}&beginDate={beginDate}&endDate={endDate}&includeContent={includeContent}	Retrieves attachments for the given parameters. All parameters are optional.
GET Attachments/ByLastModifiedDate?assetId={assetId}&beginDate={beginDate}&endDate={endDate}&includeContent={includeContent}	Retrieves attachments for the given parameters. All parameters are optional.
GET Attachments?assetId={assetId}&includeContent={includeContent}&take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves attachments for the given parameters. All parameters are optional.
GET Attachments?attachmentId={attachmentId}	Retrieves an attachment by its Id.
POST Attachments	Creates a new attachment.
PUT Attachments	Updates the given attachment. Only the Name and Description of the attachment may be updated.
DELETE Attachments	Deletes the given attachment.

DataTypes

API	Description
GET DataTypes	Retrieves Greyswift's data types. These are read-only.
GET DataTypes?dataTypeId={dataTypeId}	Retrieves a data type by its Id.

Forms

API	Description
GET Forms/GetFile?formFieldValueId={formFieldValueId}&maxWidth={maxWidth}&maxHeight={maxHeight}&openInBrowser={openInBrowser}	Retrieves a file stream of a form field value's attachment content.
GET Forms/GetContent?formFieldValueId={formFieldValueId}&startIndex={startIndex}&chunkSize={chunkSize}	Retrieves a specified chunk of an attachment form field value's content
GET Forms/GetAnalyticsFields?formTypeName={formTypeName}&formTypeFieldNameText={formTypeFieldNameText}&beginDate={beginDate}&endDate={endDate}	Retrieves form fields for the given parameters.
GET Forms/ByEffectiveDate?assetId={assetId}&formTypeId={formTypeId}&beginDate={beginDate}&endDate={endDate}&includeAttachmentContent={includeAttachmentContent}	Retrieves forms for the given parameters. All parameters are optional.
GET Forms/ByLastModifiedDate?assetId={assetId}&formTypeId={formTypeId}&beginDate={beginDate}&endDate={endDate}&includeAttachmentContent={includeAttachmentContent}	Retrieves forms for the given parameters. All parameters are optional.
GET Forms?assetId={assetId}&formTypeId={formTypeId}&take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}&includeAttachmentContent={includeAttachmentContent}	Retrieves forms for the given parameters. All parameters are optional.
GET Forms?formId={formId}	Retrieves a form by its Id.
POST Forms	Creates a new form.
PUT Forms	Updates the given form.
DELETE Forms	Deletes the given form.

FormTypes

API	Description
PUT FormTypes/UpdateValueNeededDate	Updates the given form types's value needed date.
GET FormTypes?assetTypeId={assetTypeId}&take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves form types for the given parameters. All parameters are optional.
GET FormTypes?formTypeId={formTypeId}	Retrieves a form type by its Id.
POST FormTypes	Creates a new form type.
PUT FormTypes	Updates the given form type.
DELETE FormTypes	Deletes the given form type, including all forms of that type.

Measurements

API	Description
GET Measurements/ByEffectiveDate?assetId={assetId}&measurementTypeId={measurementTypeId}&beginDate={beginDate}&endDate={endDate}	Retrieves measurements for the given parameters. All parameters are optional.
GET Measurements/ByLastModifiedDate?assetId={assetId}&measurementTypeId={measurementTypeId}&beginDate={beginDate}&endDate={endDate}	Retrieves measurements for the given parameters. All parameters are optional.
GET Measurements?assetId={assetId}&measurementTypeId={measurementTypeId}&take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves measurements for the given parameters. All parameters are optional.
GET Measurements?measurementId={measurementId}	Retrieves a measurement by its Id.
POST Measurements	Creates a new measurement.
PUT Measurements	Updates the given measurement.
DELETE Measurements	Deletes the given measurement.

MeasurementTypes

API	Description
PUT MeasurementTypes/UpdateValueNeededDate	Updates the given measurement types's value needed date.
GET MeasurementTypes?assetTypeId={assetTypeId}&take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves measurement types for the given parameters. All parameters are optional.
GET MeasurementTypes?measurementTypeId={measurementTypeId}	Retrieves a measurement type by its Id.
POST MeasurementTypes	Creates a new measurement type.
PUT MeasurementTypes	Updates the given measurement type.
DELETE MeasurementTypes	Deletes the given measurement type, including all measurements of that type.

NoteCategories

API	Description
GET NoteCategories?take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves note categories for the given parameters. All parameters are optional.
GET NoteCategories?noteCategoryId={noteCategoryId}	Retrieves a note category by its Id.
POST NoteCategories	Creates a new note category.
PUT NoteCategories	Updates the given note category.
DELETE NoteCategories	Deletes the given note category.

Notes

API	Description
GET Notes/ByEffectiveDate?assetId={assetId}&beginDate={beginDate}&endDate={endDate}	Retrieves notes for the given parameters. All parameters are optional.
GET Notes/ByLastModifiedDate?assetId={assetId}&beginDate={beginDate}&endDate={endDate}	Retrieves notes for the given parameters. All parameters are optional.
GET Notes?assetId={assetId}&take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves notes for the given parameters. All parameters are optional.
GET Notes?noteId={noteId}	Retrieves a note by its Id
POST Notes	Creates a new note.
PUT Notes	Updates the given note.
DELETE Notes	Deletes the given note.

Properties

API	Description
GET Properties/ByLastModifiedDate?assetId={assetId}&propertyTypeId={propertyTypeId}&beginDate={beginDate}&endDate={endDate}	Retrieves properties for the given parameters. All parameters are optional.
GET Properties/GetAllForAsset?assetId={assetId}	Retrieves all properties for the given asset. This includes properties of that asset that may not have a value.
GET Properties?assetId={assetId}&propertyTypeId={propertyTypeId}&take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves properties for the given parameters. This will only retrieve properties that have a value. All parameters are optional.
GET Properties?propertyId={propertyId}	Retrieves a property by its Id.
POST Properties	Creates a new property.
PUT Properties	Updates the given property.
DELETE Properties	Deletes the given property.

PropertyTypes

API	Description
GET PropertyTypes?assetTypeId={assetTypeId}&take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves property types for the given parameters.
GET PropertyTypes?propertyTypeId={propertyTypeId}	Retrieves a property type by its Id.
POST PropertyTypes	Creates a new property type.
PUT PropertyTypes	Updates the given property type.
DELETE PropertyTypes	Deletes the given property type, including all properties of that type.

TaskCategories

API	Description
GET TaskCategories?take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves task categories for the given parameters. All parameters are optional.
GET TaskCategories?taskCategoryId={taskCategoryId}	Retrieves an task category by its Id.
POST TaskCategories	Creates a new task category.
PUT TaskCategories	Updates the given task category.
DELETE TaskCategories	Deletes the given task category.

Tasks

API	Description
GET Tasks/GetFile?taskAttachmentId={taskAttachmentId}&taskFieldValueId={taskFieldValueId}&maxWidth={maxWidth}&maxHeight={maxHeight}&openInBrowser={openInBrowser}	Retrieves a file stream of a task attachment's or task field value's content.
GET Tasks/GetContent?startIndex={startIndex}&chunkSize={chunkSize}&taskAttachmentId={taskAttachmentId}&taskFieldValueId={taskFieldValueId}	Retrieves a specified chunk of a task attachment's or task field value's content
GET Tasks/ByLastModifiedDate?assetId={assetId}&taskSourceTypeId={taskSourceTypeId}&beginDate={beginDate}&endDate={endDate}&includeAttachmentContent={includeAttachmentContent}	Retrieves tasks for the given parameters. All parameters are optional.
GET Tasks?assetId={assetId}&take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}&includeAttachmentContent={includeAttachmentContent}	Retrieves tasks for the given parameters. All parameters are optional.
GET Tasks?taskId={taskId}	Retrieves a task by its Id.
POST Tasks?sendNotification={sendNotification}	Creates a new task.
PUT Tasks?sendNotification={sendNotification}	Updates the given task.
DELETE Tasks	Deletes the given task.

TaskStatusTypes

API	Description
GET TaskStatusTypes?includeCompanyId={includeCompanyId}&includeDefaults={includeDefaults}	Retrieves Greyswift's task status types. These are read-only.
GET TaskStatusTypes?taskStatusTypeId={taskStatusTypeId}	Retrieves a task status type by its Id.
POST TaskStatusTypes	Creates a task status type.
PUT TaskStatusTypes	Updates a task status type by its Id.
DELETE TaskStatusTypes	Deletes a task status type by its Id.

TaskStatusTypeTaskType

API	Description
GET TaskStatusTypeTaskType?taskStatusTypeTaskTypeId={taskStatusTypeTaskTypeId}&taskStatusTypeId={taskStatusTypeId}&taskTypeId={taskTypeId}	Retrieves a companies task status types to task types association. These are read-only.
POST TaskStatusTypeTaskType	Creates a task status type.
DELETE TaskStatusTypeTaskType	Deletes a task status type by its Id.

TaskTypes

API	Description
GET TaskTypes?take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves task types for the given parameters. All parameters are optional.
GET TaskTypes?taskTypeId={taskTypeId}	Retrieves a task type by its Id.
POST TaskTypes	No documentation available.
PUT TaskTypes	Updates the given task type.
DELETE TaskTypes	Deletes the given task type, including all tasks of that type.

Teams

API	Description
GET Teams?take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves teams for the given parameters. All parameters are optional.
GET Teams?teamId={teamId}	Retrieves a team by its Id.
POST Teams	Creates a new team.
PUT Teams	Updates the given team.
DELETE Teams	Deletes the given team.

Units

API	Description
GET Units?take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves units for the given parameters. All parameters are optional.
GET Units?unitId={unitId}	Retrieves a unit by its Id.
POST Units	Creates a unit.
PUT Units	Updates the given unit.
DELETE Units	Deletes the given unit. This will not delete property types or measurement types that use this unit.

Users

API	Description
POST Users/Validate	Validates the given user.
GET Users?take={take}&skip={skip}&sort[0].Field={sort[0].Field}&sort[0].Dir={sort[0].Dir}&sort[1].Field={sort[1].Field}&sort[1].Dir={sort[1].Dir}	Retrieves users for the given parameters. All parameters are optional.
GET Users?userId={userId}	Retrieves a user by their Id.
POST Users	Creates a new user.
PUT Users	Updates the given user.
DELETE Users	Deletes the given user. The user to delete cannot be in the Owner role. Also, the user making this request cannot delete their own account.