WiseTime Connect API (1.2.1)

Download OpenAPI specification:Download

WiseTime Connect API Support: contact@wisetime.io URL: https://wisetime.io/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

200

Successfully found the team info.

401

A valid API key is required to access this resource.

500

An unexpected error occured.

get /team/info

https://wisetime.io/connect/api/team/info

Response samples

200

application/json

Copy

Expand all Collapse all

{

"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.
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.
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.
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.

Responses

200

Tag successfully created or updated.

400

Invalid request. Tag name is required.

401

A valid API key is required to access this resource.

402

Number of tags plan limit exceeded.

500

An unexpected error occured.

post /tag

https://wisetime.io/connect/api/tag

Request samples

Payload

application/json

Copy

Expand all Collapse all

{

"name": "string",
"description": "string",
"excludeTagNameKeyword": true,
"path": "string",
"additionalKeywords":
[
- "string"
]

}

Response samples

200

application/json

Copy

Expand all Collapse all

{ }

Delete an existing tag

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

name	string Tag name to delete.

Responses

200

Tag successfully updated.

400

Invalid request. Tag name is required.

401

A valid API key is required to access this resource.

404

Tag not found.

500

An unexpected error occured.

post /tag/delete

https://wisetime.io/connect/api/tag/delete

Request samples

Payload

application/json

Copy

Expand all Collapse all

{

"name": "string"

}

Response samples

200

application/json

Copy

Expand all Collapse all

{ }

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.
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

200

Keyword(s) successfully added.

400

Invalid request. Tag name and additional keywords are required.

401

A valid API key is required to access this resource.

404

Tag not found.

500

An unexpected error occured.

post /tag/keyword

https://wisetime.io/connect/api/tag/keyword

Request samples

Payload

application/json

Copy

Expand all Collapse all

{

"tagName": "string",
"additionalKeywords":
[
- "string"
]

}

Response samples

200

application/json

Copy

Expand all Collapse all

{ }

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

200

Tag successfully deleted.

400

Invalid request. Tag name and keyword are required.

401

A valid API key is required to access this resource.

404

Tag or keyword not found.

500

An unexpected error occured.

post /tag/keyword/delete

https://wisetime.io/connect/api/tag/keyword/delete

Request samples

Payload

application/json

Copy

Expand all Collapse all

{

"tagName": "string",
"keyword": "string"

}

Response samples

200

application/json

Copy

Expand all Collapse all

{ }

Posted Time

Returns posted time for the team.

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

200

List of posted time events.

400

Invalid request. Limit cannot be smaller than 1.

401

A valid API key is required to access this resource.

500

An unexpected error occured.

get /postedtime

https://wisetime.io/connect/api/postedtime

Response samples

200

application/json

Copy

Expand all Collapse all

[

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

]

Register the intent to fetch time from the /postedtime endpoint.

WiseTime will start recording posted time events that can be fetched via the /postedtime endpoint.

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

Responses

200

Fetch client successfully registered.

400

Invalid request. Callback URL is required.

401

A valid API key is required to access this resource.

409

This team already has a registered fetch client or webhook.

500

An unexpected error occured.

post /postedtime/registerfetchclient

https://wisetime.io/connect/api/postedtime/registerfetchclient

Request samples

Payload

application/json

Copy

Expand all Collapse all

{ }

Response samples

200

application/json

Copy

Expand all Collapse all

{ }

Delete existing fetch client, unsubscribing your application from posted time fetching.

WiseTime will stop recording posted time events for fetch when users post time to your team.

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

Responses

200

Fetch client successfully unregistered.

401

A valid API key is required to access this resource.

404

Fetch client not found.

500

An unexpected error occured.

post /postedtime/unregisterfetchclient

https://wisetime.io/connect/api/postedtime/unregisterfetchclient

Request samples

Payload

application/json

Copy

Expand all Collapse all

{ }

Response samples

200

application/json

Copy

Expand all Collapse all

{ }

Updates the status of a received time group. Providing its success or failure to be processed.

This is intended for use with the fetch mechanism only. Not to be used with webhooks. If this endpoint isn't called for a time group within a certain amount of time after fetching it the time group will be made available again for fetching.

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

timeGroupId	string ID of the time group to be updated.
status	string Enum:"SUCCESS""FAILURE" This field describes the status of the posted time group. On SUCCESS the time group will be marked as successfully posted. On FAILURE the time group will be marked as failed and the attached message will displayed to the user.
message	string Reason for the failure, will be displayed to the user.

Responses

200

Status of the time group was updated successfully.

400

Invalid request.

401

A valid API key is required to access this resource.

404

The time group/fetch client id pair was not found.

500

An unexpected error occured.

post /postedtime/status

https://wisetime.io/connect/api/postedtime/status

Request samples

Payload

application/json

Copy

Expand all Collapse all

{

"timeGroupId": "string",
"status": "SUCCESS",
"message": "string"

}

Subscribe to be notified when a user posts time information to your team.

WiseTime will call your webhook with a payload of the posted time information. See the posted time webhook documentation for details. Each team is limited to one webhook callback.

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

callbackUrl required	string The webhook URL that WiseTime will call to notify you of user posted time.
callerKey	string WiseTime will send this key back to you when it calls your webhook. That way you can authenticate that the request comes from WiseTime.

Responses

200

Webhook subscription successfully created.

400

Invalid request. Callback URL is required.

401

A valid API key is required to access this resource.

409

This team already has a registered webhook or fetch client.

500

An unexpected error occured.

post /postedtime/subscribe

https://wisetime.io/connect/api/postedtime/subscribe

Request samples

Payload

application/json

Copy

Expand all Collapse all

{

"callbackUrl": "string",
"callerKey": "string"

}

Response samples

200

application/json

Copy

Expand all Collapse all

{

"webhookId": "string"

}

Delete existing webhook by id, unsubscribing your application from posted time notifications.

WiseTime will stop calling your webhook when users post time to your team.

Authorizations:

ConnectApiKeyAuth

Request Body schema: application/json

webhookId

string

The ID of the webhook to be deleted.

Responses

200

Webhook successfully deleted.

401

A valid API key is required to access this resource.

404

Webhook not found.

500

An unexpected error occured.

post /postedtime/unsubscribe

https://wisetime.io/connect/api/postedtime/unsubscribe

Request samples

Payload

application/json

Copy

Expand all Collapse all

{

"webhookId": "string"

}

Response samples

200

application/json

Copy

Expand all Collapse all

{ }