WiseTime Connect API (1.3.0)

Download OpenAPI specification:Download

WiseTime Connect API Support: contact@wisetime.com URL: https://wisetime.com/docs/connect

Use the WiseTime Connect API to build connectors to your application.

Authentication

ConnectApiKeyAuth

See the Authentication documentation page for more details.

Security Scheme Type	API Key
Header parameter name:	x-api-key

Team Info

Retrieve information about the team

Authorizations:

ConnectApiKeyAuth

Responses

Response samples

200

Content type

application/json

{"teamName": "string"
}

Tags

Create a new tag, or update the tag if it already exists

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

name	string Tag name to create. If a tag by this name already exists, the tag will be updated.
description	string Displayed in the GUI and search functions. An empty (or null) description will be ignored, the description will remain with the previous value instead of replacing it.
excludeTagNameKeyword	boolean The default behaviour when creating a tag is for the tagName to be added as a keyword for the tag. If excludeTagNameKeyword is set to true, the tagName will not be added as a keyword, unless it is explicitly defined in the additionalKeywords list of the request.
tagCategoryId	string The ID of the category that this tag belongs to. This field is empty if the tag does not belong to a category.
path	string Path at which to create the tag. The path must start with a / and end with a / For example /myteam/inprotech/ Use / to create tag in root.
managedBy	string Identifier of the resource that manages this tag.
externalId	string Identifier of the tag in the connected system. The external ID will be sent when time is posted with this tag, so that the posted time can be recorded against the relevant record in the connected system.
	object (TagMetadataSet) You can assign metadata to a tag. You provide this information as a name-value (key-value) pair. The metadata names are case sensitive and will be displayed in reports, it is recommended the names be descriptive to clarify its meaning. In the case of providing any name-value where the name is already assigned as metadata to the tag, the value will be updated with value supplied. To delete/remove a name-value pair stored as metadata on a tag, you must use the `tag-metadata-delete` operation.
additionalKeywords	Array of strings A tag is applied to a time row if one of its keywords matches text in the time row activity description. Keywords provided via this property will be added to the list of existing keywords for the tag. Existing keywords won't be removed.
url	string If a URL is provided, the tag will be a clickable link in the WiseTime console. Clicking on the tag will open the URL.
visibility	string Enum: "PUBLIC" "PRIVATE" Defines tag visibility. Default is PUBLIC. Private matters are only accessible by explicitly authorized team members.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"description": "string",
"excludeTagNameKeyword": true,
"tagCategoryId": "string",
"path": "string",
"managedBy": "string",
"externalId": "string",
"metadata": {"Billing Group": "billable"
},
"additionalKeywords": ["string"
],
"url": "string",
"visibility": "PUBLIC"
}

Response samples

200

Content type

application/json

{ }

Create new tags, or update existing in batch (up to 2000 items at once)

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

Array of objects (UpsertTagRequest) [ items ]

Responses

Request samples

Payload

Content type

application/json

{"tags": [{"name": "string",
"description": "string",
"excludeTagNameKeyword": true,
"tagCategoryId": "string",
"path": "string",
"managedBy": "string",
"externalId": "string",
"metadata": {"Billing Group": "billable"
},
"additionalKeywords": ["string"
],
"url": "string",
"visibility": "PUBLIC"
}
]
}

Response samples

400

Content type

application/json

{"errors": [{"index": 0,
"errorDescription": "string"
}
]
}

Delete an existing tag

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

One of

name	string Tag name to delete.

Responses

Request samples

Payload

Content type

application/json

{"id": "string"
}

Response samples

200

Content type

application/json

{ }

Permanently deletes the specified metadata from an existing tag.

Provide the metadata names that you want to delete.

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

tagName required	string The tag from which to delete the tag metadata.
metadataNames required	Array of strings The name(s) of the tag metadata to delete.

Responses

Request samples

Payload

Content type

application/json

{"tagName": "string",
"metadataNames": ["string"
]
}

Response samples

200

Content type

application/json

{ }

Add one or more keywords to an existing tag

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

tagName	string The tag to which to add the keywords.
externalId	string The identifier of the tag in the connected system.
additionalKeywords	Array of strings One or more new keywords for the tag. Keywords provided via this property will be added to the list of existing keywords for the tag. Existing keywords won't be removed.

Responses

Request samples

Payload

Content type

application/json

{"tagName": "string",
"externalId": "string",
"additionalKeywords": ["string"
]
}

Response samples

200

Content type

application/json

{ }

Delete an existing keyword from a tag

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

tagName	string The tag from which to delete the keywords.
keyword	string The keyword to delete.

Responses

Request samples

Payload

Content type

application/json

{"tagName": "string",
"keyword": "string"
}

Response samples

200

Content type

application/json

{ }

Tag Categories

Create new tag categories, or update existing in batch (up to 2000 items at once). If tag category is not found by external ID, it is created. externalId is a required field to use the batch creation endpoint. No partial update, if some of categories failed to be processed, entire batch considered faulty.

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

Array of objects (TagCategory) [ items ]

An array of tag categories to be created/updated.

Responses

Request samples

Payload

Content type

application/json

{"tagCategories": [{"id": "string",
"externalId": "string",
"label": "string",
"description": "string",
"keywords": ["string"
]
}
]
}

Response samples

200

Content type

application/json

{"tagCategories": [{"id": "string",
"externalId": "string",
"label": "string",
"description": "string",
"keywords": ["string"
]
}
]
}

Activity Types

Start activity types sync session

Initiates a sync session and responds with syncSessionId that can be used for further activity types uploads within the session. While activity types can be sent to WiseTime in batches without a sync session, starting a sync session for the batch uploads means that WiseTime will be able to detect activity types that are no longer in the connected system, and delete these when the sync session is completed by the connector.

Authorizations:

ConnectApiKeyAuth

Responses

Response samples

200

Content type

application/json

{"syncSessionId": "string"
}

Complete activity types sync session

Completes a sync session so its syncSessionId can not be used anymore. All the activity types that were lastly created/updated before the session start will be deleted.

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

syncSessionId

string

Sync session identifier that can be used for the patch uploads or session completion/cancellation.

Responses

Request samples

Payload

Content type

application/json

{"syncSessionId": "string"
}

Cancel activity types sync session

Cancels a sync session so its syncSessionId can not be used anymore. This API call has no impact on activity types.

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

syncSessionId

string

Sync session identifier that can be used for the patch uploads or session completion/cancellation.

Responses

Request samples

Payload

Content type

application/json

{"syncSessionId": "string"
}

Create new activity types, or update existing in batch (up to 2000 items at once)

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

	Array of objects (ActivityType) [ items ] An array of activity types to be created/updated.
syncSessionId	string Optional. Identifier of the sync session.

Responses

Request samples

Payload

Content type

application/json

{"activityTypes": [{"code": "string",
"label": "string",
"description": "string",
"enableIfNew": true
}
],
"syncSessionId": "string"
}

Response samples

200

Content type

application/json

{"errors": [{"index": 0,
"errorDescription": "string"
}
]
}

Posted Time

Returns posted time with pending status.

Use this endpoint to fetch posted time for processing. This is a long polling call (an alternative to using the webhook mechanism). The connection will be held open for a maximum of 60 seconds or until there is a new posted time event. When calling this method without first calling the /postedtime/registerfetchclient endpoint, recording posted time for fetching will implicitly be turned on.

Authorizations:

ConnectApiKeyAuth

query Parameters

limit

integer

Maximum amount of posted time entries to retrieve. If not set, the API will return up to a maximum of 25 entries for each request.

Responses

Response samples

200

Content type

application/json

[{"callerKey": "string",
"groupId": "string",
"description": "string",
"totalDurationSecs": 0,
"groupName": "string",
"narrativeType": "NARRATIVE_AND_TIME_ROW_ACTIVITY_DESCRIPTIONS",
"status": "PENDING",
"submissionTime": 0,
"tags": [{"name": "string",
"path": "string",
"description": "string",
"externalId": "string"
}
],
"timeRows": [{"activity": "string",
"description": "string",
"activityHour": 0,
"firstObservedInHour": 0,
"durationSecs": 0,
"submittedDate": 0,
"modifier": "string",
"activityTypeCode": "string",
"source": "WT_DESKTOP",
"timezone_name": "string",
"timezone_offset_min": 0
}
],
"user": {"userId": "string",
"name": "string",
"email": "string",
"externalId": "string",
"businessRole": "string",
"experienceWeightingPercent": 0
},
"originatingUser": {"userId": "string",
"name": "string",
"email": "string",
"externalId": "string",
"businessRole": "string",
"experienceWeightingPercent": 0
},
"durationSplitStrategy": "DIVIDE_BETWEEN_TAGS"
}
]

Returns list of posted time with pending or success status.

Returns all time groups for team in descending order of submission time starting from now. This is not a long polling endpoint.

Authorizations:

ConnectApiKeyAuth

query Parameters

limit	integer Maximum number of items to return. Should be between 1 and 500. Default is 100.
submittedBefore	integer Filter response to return only time groups submitted before requested timestamp. If empty - returns latest time groups. Note that the submisisonTime may be the same for multiple time groups as users may submit more than 1 time group as a single operation. Measured in milliseconds since the Epoch.

Responses

Response samples

200

Content type

application/json

[{"callerKey": "string",
"groupId": "string",
"description": "string",
"totalDurationSecs": 0,
"groupName": "string",
"narrativeType": "NARRATIVE_AND_TIME_ROW_ACTIVITY_DESCRIPTIONS",
"