{ "service": "datascope", "displayName": "DataScope", "categories": [ "Productivity", "Data" ], "authTypes": [ "api_key" ], "auth": [ { "type": "api_key", "label": "API Key", "placeholder": "DATASCOPE_API_KEY", "description": "DataScope API key sent with the Authorization header. Find it in the DataScope API setup guide: https://help.mydatascope.com/en/articles/9628405-datascope-api" } ], "homepageUrl": "https://www.mydatascope.com", "actions": [ { "id": "datascope.create_list_element", "service": "datascope", "name": "create_list_element", "description": "Create one DataScope metadata list element under a metadata list type.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "metadataType": { "type": "string", "minLength": 1, "description": "The metadata list type that will own the new element." }, "code": { "type": "string", "minLength": 1, "description": "The code to store on the new metadata list element." }, "name": { "type": "string", "minLength": 1, "description": "The display name of the new metadata list element." }, "description": { "type": "string", "minLength": 1, "description": "The description to store on the metadata list element." }, "attribute1": { "type": "string", "minLength": 1, "description": "The first custom attribute to store on the element." }, "attribute2": { "type": "string", "minLength": 1, "description": "The second custom attribute to store on the element." } }, "additionalProperties": false, "required": [ "metadataType", "code", "name" ] }, "outputSchema": { "type": "object", "properties": { "element": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The unique identifier of the metadata list element." }, "metadataType": { "type": "string", "minLength": 1, "description": "The metadata list type that owns this element." }, "code": { "type": "string", "minLength": 1, "description": "The list element code returned by DataScope." }, "name": { "type": "string", "minLength": 1, "description": "The list element name returned by DataScope." }, "description": { "type": "string", "minLength": 1, "description": "The list element description returned by DataScope." }, "attribute1": { "type": "string", "minLength": 1, "description": "The first custom attribute returned by DataScope." }, "attribute2": { "type": "string", "minLength": 1, "description": "The second custom attribute returned by DataScope." }, "listId": { "type": "integer", "minimum": 1, "description": "The parent list identifier returned by DataScope." }, "accountId": { "type": "integer", "minimum": 1, "description": "The account identifier returned by DataScope." }, "createdAt": { "type": "string", "minLength": 1, "description": "The creation timestamp returned by DataScope." }, "updatedAt": { "type": "string", "minLength": 1, "description": "The last-updated timestamp returned by DataScope." } }, "additionalProperties": false, "required": [ "id", "name" ], "description": "One normalized DataScope metadata list element." } }, "additionalProperties": false, "required": [ "element" ], "description": "Action output." } }, { "id": "datascope.create_location", "service": "datascope", "name": "create_location", "description": "Create a DataScope location using the official locations endpoint.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1, "description": "The location code to store in DataScope." }, "name": { "type": "string", "minLength": 1, "description": "The location name to store in DataScope." }, "description": { "type": "string", "minLength": 1, "description": "The location description to store in DataScope." }, "address": { "type": "string", "minLength": 1, "description": "The location address to store in DataScope." }, "city": { "type": "string", "minLength": 1, "description": "The city to store in DataScope." }, "country": { "type": "string", "minLength": 1, "description": "The country to store in DataScope." }, "region": { "type": "string", "minLength": 1, "description": "The region to store in DataScope." }, "latitude": { "type": "number", "description": "The latitude to store in DataScope." }, "longitude": { "type": "number", "description": "The longitude to store in DataScope." }, "phone": { "type": "string", "minLength": 1, "description": "The phone number to store in DataScope." }, "email": { "type": "string", "minLength": 1, "description": "The contact email to store in DataScope." }, "companyCode": { "type": "string", "minLength": 1, "description": "The company code to store in DataScope." }, "companyName": { "type": "string", "minLength": 1, "description": "The company name to store in DataScope." } }, "additionalProperties": false, "required": [ "code", "name" ] }, "outputSchema": { "type": "object", "properties": { "location": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The unique identifier of the DataScope location." }, "code": { "type": "string", "minLength": 1, "description": "The location code returned by DataScope." }, "name": { "type": "string", "minLength": 1, "description": "The location name returned by DataScope." }, "description": { "type": "string", "minLength": 1, "description": "The location description returned by DataScope." }, "address": { "type": "string", "minLength": 1, "description": "The location address returned by DataScope." }, "city": { "type": "string", "minLength": 1, "description": "The city returned by DataScope." }, "country": { "type": "string", "minLength": 1, "description": "The country returned by DataScope." }, "region": { "type": "string", "minLength": 1, "description": "The region returned by DataScope." }, "latitude": { "type": "number", "description": "The latitude returned by DataScope." }, "longitude": { "type": "number", "description": "The longitude returned by DataScope." }, "phone": { "type": "string", "minLength": 1, "description": "The phone number returned by DataScope." }, "email": { "type": "string", "minLength": 1, "description": "The contact email returned by DataScope." }, "companyCode": { "type": "string", "minLength": 1, "description": "The company code returned by DataScope." }, "companyName": { "type": "string", "minLength": 1, "description": "The company name returned by DataScope." } }, "additionalProperties": false, "required": [ "id", "name" ], "description": "One normalized DataScope location." } }, "additionalProperties": false, "required": [ "location" ], "description": "Action output." } }, { "id": "datascope.get_list_element", "service": "datascope", "name": "get_list_element", "description": "Get one DataScope metadata list element by metadata type and element ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "metadataType": { "type": "string", "minLength": 1, "description": "The metadata list type that owns the element." }, "elementId": { "type": "integer", "minimum": 1, "description": "The identifier of the metadata list element to fetch." } }, "additionalProperties": false, "required": [ "metadataType", "elementId" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "element": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The unique identifier of the metadata list element." }, "metadataType": { "type": "string", "minLength": 1, "description": "The metadata list type that owns this element." }, "code": { "type": "string", "minLength": 1, "description": "The list element code returned by DataScope." }, "name": { "type": "string", "minLength": 1, "description": "The list element name returned by DataScope." }, "description": { "type": "string", "minLength": 1, "description": "The list element description returned by DataScope." }, "attribute1": { "type": "string", "minLength": 1, "description": "The first custom attribute returned by DataScope." }, "attribute2": { "type": "string", "minLength": 1, "description": "The second custom attribute returned by DataScope." }, "listId": { "type": "integer", "minimum": 1, "description": "The parent list identifier returned by DataScope." }, "accountId": { "type": "integer", "minimum": 1, "description": "The account identifier returned by DataScope." }, "createdAt": { "type": "string", "minLength": 1, "description": "The creation timestamp returned by DataScope." }, "updatedAt": { "type": "string", "minLength": 1, "description": "The last-updated timestamp returned by DataScope." } }, "additionalProperties": false, "required": [ "id", "name" ], "description": "One normalized DataScope metadata list element." } }, "additionalProperties": false, "required": [ "element" ], "description": "Action output." } }, { "id": "datascope.list_answers", "service": "datascope", "name": "list_answers", "description": "List DataScope answers from the v2 answers endpoint with stable top-level metadata and dynamic answer values grouped under answers.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "formId": { "type": "integer", "minimum": 1, "description": "The DataScope form identifier to filter by." }, "userId": { "type": "integer", "minimum": 1, "description": "The DataScope user identifier to filter by." }, "locationId": { "type": "integer", "minimum": 1, "description": "The DataScope location identifier to filter by." }, "startAt": { "type": "string", "minLength": 1, "description": "The inclusive start timestamp filter sent to DataScope." }, "endAt": { "type": "string", "minLength": 1, "description": "The inclusive end timestamp filter sent to DataScope." }, "dateModified": { "type": "boolean", "description": "Whether DataScope should filter answers by modified date instead of created date." }, "limit": { "type": "integer", "minimum": 1, "maximum": 200, "description": "The maximum number of answers to return. DataScope allows at most 200." }, "offset": { "type": "integer", "minimum": 0, "description": "The zero-based offset used to fetch the next page." } }, "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "answers": { "type": "array", "items": { "type": "object", "properties": { "formId": { "type": "integer", "minimum": 1, "description": "The DataScope form identifier." }, "formAnswerId": { "type": "integer", "minimum": 1, "description": "The unique identifier of the submitted answer." }, "formCode": { "type": "string", "minLength": 1, "description": "The public code of the DataScope form." }, "formName": { "type": "string", "minLength": 1, "description": "The form name returned by DataScope." }, "formState": { "type": "string", "minLength": 1, "description": "The workflow state of the submitted answer." }, "userName": { "type": "string", "minLength": 1, "description": "The display name of the user who submitted the answer." }, "userIdentifier": { "type": "string", "minLength": 1, "description": "The unique user identifier returned by DataScope, such as an email address." }, "createdAt": { "type": "string", "minLength": 1, "description": "The submission timestamp returned by DataScope." }, "latitude": { "type": "number", "description": "The latitude captured for the answer when available." }, "longitude": { "type": "number", "description": "The longitude captured for the answer when available." }, "answers": { "type": "object", "additionalProperties": { "description": "The raw answer value returned by DataScope." }, "description": "The dynamic answer values keyed by question label or field name." } }, "additionalProperties": false, "required": [ "formId", "formAnswerId", "answers" ], "description": "One normalized DataScope answer summary." }, "description": "The normalized answers returned by DataScope." } }, "additionalProperties": false, "required": [ "answers" ], "description": "Action output." } }, { "id": "datascope.list_answers_with_full_metadata", "service": "datascope", "name": "list_answers_with_full_metadata", "description": "List DataScope answers from the metadata-rich answers endpoint and normalize each question item into a stable questions array.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "formId": { "type": "integer", "minimum": 1, "description": "The DataScope form identifier to filter by." }, "userId": { "type": "integer", "minimum": 1, "description": "The DataScope user identifier to filter by." }, "locationId": { "type": "integer", "minimum": 1, "description": "The DataScope location identifier to filter by." }, "startAt": { "type": "string", "minLength": 1, "description": "The inclusive start timestamp filter sent to DataScope." }, "endAt": { "type": "string", "minLength": 1, "description": "The inclusive end timestamp filter sent to DataScope." } }, "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "answers": { "type": "array", "items": { "type": "object", "properties": { "formId": { "type": "integer", "minimum": 1, "description": "The DataScope form identifier." }, "formAnswerId": { "type": "integer", "minimum": 1, "description": "The unique identifier of the submitted answer." }, "formCode": { "type": "string", "minLength": 1, "description": "The public code of the DataScope form." }, "formName": { "type": "string", "minLength": 1, "description": "The form name returned by DataScope." }, "formState": { "type": "string", "minLength": 1, "description": "The workflow state of the submitted answer." }, "userName": { "type": "string", "minLength": 1, "description": "The display name of the user who submitted the answer." }, "userIdentifier": { "type": "string", "minLength": 1, "description": "The unique user identifier returned by DataScope, such as an email address." }, "createdAt": { "type": "string", "minLength": 1, "description": "The submission timestamp returned by DataScope." }, "updatedAt": { "type": "string", "minLength": 1, "description": "The last-updated timestamp returned by DataScope." }, "latitude": { "type": "number", "description": "The latitude captured for the answer when available." }, "longitude": { "type": "number", "description": "The longitude captured for the answer when available." }, "finished": { "type": "boolean", "description": "Whether DataScope marks the answer as finished." }, "assignId": { "anyOf": [ { "type": "integer", "description": "The assignment identifier attached to the answer when available." }, { "type": "string", "description": "The assignment identifier attached to the answer when available." } ], "description": "The assignment identifier attached to the answer when available." }, "assignInternalId": { "anyOf": [ { "type": "integer", "description": "The internal assignment identifier attached to the answer when available." }, { "type": "string", "description": "The internal assignment identifier attached to the answer when available." } ], "description": "The internal assignment identifier attached to the answer when available." }, "assignLocationName": { "type": "string", "minLength": 1, "description": "The assignment location name attached to the answer when available." }, "assignLocationDescription": { "type": "string", "minLength": 1, "description": "The assignment location description attached to the answer when available." }, "assignLocationCode": { "type": "string", "minLength": 1, "description": "The assignment location code attached to the answer when available." }, "questions": { "type": "array", "items": { "type": "object", "properties": { "formId": { "type": "integer", "minimum": 1, "description": "The DataScope form identifier that owns this answer field." }, "formAnswerId": { "type": "integer", "minimum": 1, "description": "The answer identifier that owns this answer field." }, "formCode": { "type": "string", "minLength": 1, "description": "The public code of the DataScope form." }, "formState": { "type": "string", "minLength": 1, "description": "The workflow state of the answer." }, "questionId": { "type": "integer", "minimum": 1, "description": "The unique identifier of the form question." }, "questionName": { "type": "string", "minLength": 1, "description": "The visible question label returned by DataScope." }, "name": { "type": "string", "minLength": 1, "description": "The internal question name returned by DataScope." }, "questionValue": { "description": "The raw answer value returned for this question." }, "questionType": { "type": "string", "minLength": 1, "description": "The question type returned by DataScope." }, "subformIndex": { "type": "integer", "minimum": 1, "description": "The 1-based subform item index when present." }, "metadataType": { "type": "string", "minLength": 1, "description": "The metadata list type referenced by this question." }, "metadataId": { "type": "integer", "minimum": 1, "description": "The metadata element identifier referenced by this question." } }, "additionalProperties": false, "required": [ "questionValue" ], "description": "One normalized answer item from the metadata-rich DataScope answers endpoint." }, "description": "The normalized question items returned for this answer." } }, "additionalProperties": false, "required": [ "formId", "formAnswerId", "questions" ], "description": "One normalized DataScope answer with per-question metadata." }, "description": "The normalized answers with per-question metadata." } }, "additionalProperties": false, "required": [ "answers" ], "description": "Action output." } }, { "id": "datascope.list_list_elements", "service": "datascope", "name": "list_list_elements", "description": "List all elements from one DataScope metadata list type.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "metadataType": { "type": "string", "minLength": 1, "description": "The metadata list type, such as products or customers." } }, "additionalProperties": false, "required": [ "metadataType" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "elements": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The unique identifier of the metadata list element." }, "metadataType": { "type": "string", "minLength": 1, "description": "The metadata list type that owns this element." }, "code": { "type": "string", "minLength": 1, "description": "The list element code returned by DataScope." }, "name": { "type": "string", "minLength": 1, "description": "The list element name returned by DataScope." }, "description": { "type": "string", "minLength": 1, "description": "The list element description returned by DataScope." }, "attribute1": { "type": "string", "minLength": 1, "description": "The first custom attribute returned by DataScope." }, "attribute2": { "type": "string", "minLength": 1, "description": "The second custom attribute returned by DataScope." }, "listId": { "type": "integer", "minimum": 1, "description": "The parent list identifier returned by DataScope." }, "accountId": { "type": "integer", "minimum": 1, "description": "The account identifier returned by DataScope." }, "createdAt": { "type": "string", "minLength": 1, "description": "The creation timestamp returned by DataScope." }, "updatedAt": { "type": "string", "minLength": 1, "description": "The last-updated timestamp returned by DataScope." } }, "additionalProperties": false, "required": [ "id", "name" ], "description": "One normalized DataScope metadata list element." }, "description": "The normalized metadata list elements returned by DataScope." } }, "additionalProperties": false, "required": [ "elements" ], "description": "Action output." } }, { "id": "datascope.list_locations", "service": "datascope", "name": "list_locations", "description": "List DataScope locations available to the authenticated account.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No input parameters are required." }, "outputSchema": { "type": "object", "properties": { "locations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The unique identifier of the DataScope location." }, "code": { "type": "string", "minLength": 1, "description": "The location code returned by DataScope." }, "name": { "type": "string", "minLength": 1, "description": "The location name returned by DataScope." }, "description": { "type": "string", "minLength": 1, "description": "The location description returned by DataScope." }, "address": { "type": "string", "minLength": 1, "description": "The location address returned by DataScope." }, "city": { "type": "string", "minLength": 1, "description": "The city returned by DataScope." }, "country": { "type": "string", "minLength": 1, "description": "The country returned by DataScope." }, "region": { "type": "string", "minLength": 1, "description": "The region returned by DataScope." }, "latitude": { "type": "number", "description": "The latitude returned by DataScope." }, "longitude": { "type": "number", "description": "The longitude returned by DataScope." }, "phone": { "type": "string", "minLength": 1, "description": "The phone number returned by DataScope." }, "email": { "type": "string", "minLength": 1, "description": "The contact email returned by DataScope." }, "companyCode": { "type": "string", "minLength": 1, "description": "The company code returned by DataScope." }, "companyName": { "type": "string", "minLength": 1, "description": "The company name returned by DataScope." } }, "additionalProperties": false, "required": [ "id", "name" ], "description": "One normalized DataScope location." }, "description": "The normalized locations returned by DataScope." } }, "additionalProperties": false, "required": [ "locations" ], "description": "Action output." } }, { "id": "datascope.update_list_element", "service": "datascope", "name": "update_list_element", "description": "Update one DataScope metadata list element by element ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "elementId": { "type": "integer", "minimum": 1, "description": "The identifier of the metadata list element to update." }, "code": { "type": "string", "minLength": 1, "description": "The code to store on the metadata list element." }, "name": { "type": "string", "minLength": 1, "description": "The display name to store on the metadata list element." }, "description": { "type": "string", "minLength": 1, "description": "The description to store on the metadata list element." }, "attribute1": { "type": "string", "minLength": 1, "description": "The first custom attribute to store on the element." }, "attribute2": { "type": "string", "minLength": 1, "description": "The second custom attribute to store on the element." } }, "additionalProperties": false, "required": [ "elementId" ] }, "outputSchema": { "type": "object", "properties": { "element": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The unique identifier of the metadata list element." }, "metadataType": { "type": "string", "minLength": 1, "description": "The metadata list type that owns this element." }, "code": { "type": "string", "minLength": 1, "description": "The list element code returned by DataScope." }, "name": { "type": "string", "minLength": 1, "description": "The list element name returned by DataScope." }, "description": { "type": "string", "minLength": 1, "description": "The list element description returned by DataScope." }, "attribute1": { "type": "string", "minLength": 1, "description": "The first custom attribute returned by DataScope." }, "attribute2": { "type": "string", "minLength": 1, "description": "The second custom attribute returned by DataScope." }, "listId": { "type": "integer", "minimum": 1, "description": "The parent list identifier returned by DataScope." }, "accountId": { "type": "integer", "minimum": 1, "description": "The account identifier returned by DataScope." }, "createdAt": { "type": "string", "minLength": 1, "description": "The creation timestamp returned by DataScope." }, "updatedAt": { "type": "string", "minLength": 1, "description": "The last-updated timestamp returned by DataScope." } }, "additionalProperties": false, "required": [ "id", "name" ], "description": "One normalized DataScope metadata list element." } }, "additionalProperties": false, "required": [ "element" ], "description": "Action output." } }, { "id": "datascope.update_location", "service": "datascope", "name": "update_location", "description": "Update one DataScope location by location ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "locationId": { "type": "integer", "minimum": 1, "description": "The identifier of the DataScope location to update." }, "code": { "type": "string", "minLength": 1, "description": "The location code to store in DataScope." }, "name": { "type": "string", "minLength": 1, "description": "The location name to store in DataScope." }, "description": { "type": "string", "minLength": 1, "description": "The location description to store in DataScope." }, "address": { "type": "string", "minLength": 1, "description": "The location address to store in DataScope." }, "city": { "type": "string", "minLength": 1, "description": "The city to store in DataScope." }, "country": { "type": "string", "minLength": 1, "description": "The country to store in DataScope." }, "region": { "type": "string", "minLength": 1, "description": "The region to store in DataScope." }, "latitude": { "type": "number", "description": "The latitude to store in DataScope." }, "longitude": { "type": "number", "description": "The longitude to store in DataScope." }, "phone": { "type": "string", "minLength": 1, "description": "The phone number to store in DataScope." }, "email": { "type": "string", "minLength": 1, "description": "The contact email to store in DataScope." }, "companyCode": { "type": "string", "minLength": 1, "description": "The company code to store in DataScope." }, "companyName": { "type": "string", "minLength": 1, "description": "The company name to store in DataScope." } }, "additionalProperties": false, "required": [ "locationId" ] }, "outputSchema": { "type": "object", "properties": { "location": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The unique identifier of the DataScope location." }, "code": { "type": "string", "minLength": 1, "description": "The location code returned by DataScope." }, "name": { "type": "string", "minLength": 1, "description": "The location name returned by DataScope." }, "description": { "type": "string", "minLength": 1, "description": "The location description returned by DataScope." }, "address": { "type": "string", "minLength": 1, "description": "The location address returned by DataScope." }, "city": { "type": "string", "minLength": 1, "description": "The city returned by DataScope." }, "country": { "type": "string", "minLength": 1, "description": "The country returned by DataScope." }, "region": { "type": "string", "minLength": 1, "description": "The region returned by DataScope." }, "latitude": { "type": "number", "description": "The latitude returned by DataScope." }, "longitude": { "type": "number", "description": "The longitude returned by DataScope." }, "phone": { "type": "string", "minLength": 1, "description": "The phone number returned by DataScope." }, "email": { "type": "string", "minLength": 1, "description": "The contact email returned by DataScope." }, "companyCode": { "type": "string", "minLength": 1, "description": "The company code returned by DataScope." }, "companyName": { "type": "string", "minLength": 1, "description": "The company name returned by DataScope." } }, "additionalProperties": false, "required": [ "id", "name" ], "description": "One normalized DataScope location." } }, "additionalProperties": false, "required": [ "location" ], "description": "Action output." } } ] }