Entries

post

Authorizations

Path parameters

customerIdstring · objectidrequired

customer's id

userIdstring · objectidrequired

user's id

entryIdstring · objectidrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/public/customers/{customerId}/users/{userId}/entries/{entryId}/unrelease' \
  --header 'Authorization: Bearer JWT'

200

200

No body

patch

Authorizations

Path parameters

customerIdstring · objectidrequired

customer's id

userIdstring · objectidrequired

user's id

entryIdstring · objectidrequired

Body

summarystringoptional

if set, will update entry's summary

unitIncrementCountAdjustmentsnumber · doubleoptional

sum of total unit increments from this entry's sources and adjustments

initiativeIdstring · objectidoptional

if set, will update entry's initiativeId

codeIdsstring · objectid[]optional

if set, will update entry's codes

workDatestring · iso-dateoptional

the date this entry is released to

Example: 2022-08-12

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url '/api/v1/public/customers/{customerId}/users/{userId}/entries/{entryId}/override' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "summary": "text",
    "unitIncrementCountAdjustments": 1,
    "initiativeId": "text",
    "codeIds": [
      "text"
    ],
    "workDate": "2022-08-12"
  }'

200

200

{
  "entryId": "text",
  "externalId": "text",
  "customerId": "text",
  "userId": "text",
  "creationMethod": "async",
  "releasedBy": "text",
  "createdBy": "text",
  "workDate": "2022-08-12",
  "createdAt": "2022-08-12T20:44:48Z",
  "updatedAt": "2022-08-12T20:44:48Z",
  "initiativeExternalId": "text",
  "clientExternalId": "text",
  "summary": "text",
  "unitIncrementCount": 1,
  "incrementDurationInSeconds": 1,
  "lastReleasePendingAt": "2022-08-12T20:44:48Z",
  "lastReleaseFailedAt": "2022-08-12T20:44:48Z",
  "releaseSuccessAt": "2022-08-12T20:44:48Z",
  "isDeleted": true,
  "notes": "text",
  "releaseCount": 1,
  "lastSyncedAt": "2022-08-12T20:44:48Z",
  "codes": [
    {
      "codeExternalId": "text",
      "codeTypeExternalId": "text"
    }
  ]
}

delete

Authorizations

Path parameters

customerIdstring · objectidrequired

customer's id

userIdstring · objectidrequired

user's id

entryIdstring · objectidrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '/api/v1/public/customers/{customerId}/users/{userId}/entries/{entryId}' \
  --header 'Authorization: Bearer JWT'

200

200

{
  "_id": "text",
  "customerId": "text",
  "userId": "text",
  "enrichmentCorrelationId": "text",
  "statusInfo": {
    "status": "release-failed",
    "releaseFailedErrors": [
      {
        "originalMessage": "text",
        "title": "text",
        "description": "text"
      }
    ]
  },
  "creationMethod": "async",
  "workDate": "2022-08-12",
  "isLocked": true,
  "summary": "text",
  "unitIncrementCountFromSources": 1,
  "unitIncrementCountAdjustments": 1,
  "incrementDurationInSeconds": 1,
  "initiativeProps": {
    "type": "pms",
    "colorHex": "fec828",
    "tags": [
      "pinned"
    ],
    "nickname": "text",
    "initiative": {
      "type": "pms",
      "_id": "text",
      "billingType": "billable",
      "callSign": "text",
      "unitIncrements": 1,
      "externalId": "text",
      "name": "text",
      "description": "text",
      "client": {
        "_id": "text",
        "externalId": "text",
        "name": "text",
        "description": "text",
        "callSign": "text"
      }
    }
  },
  "workCodes": [
    {
      "assignedBy": "user",
      "code": {
        "_id": "text",
        "externalId": "text",
        "name": "text",
        "description": "text",
        "type": {
          "_id": "text",
          "externalId": "text",
          "name": "text",
          "semanticType": "action"
        }
      }
    }
  ],
  "sources": [
    [
      {
        "_id": "text",
        "type": "activity",
        "creationMethod": "timer",
        "category": "call",
        "technology": "zoom",
        "title": "text",
        "detail": "text",
        "startedAt": "2022-08-12T20:44:48Z",
        "stoppedAt": "2022-08-12T20:44:48Z",
        "clusterId": "text",
        "hasOverlap": true,
        "overlapTimeInSeconds": 1,
        "threadId": "text"
      }
    ]
  ],
  "externalId": "text",
  "createdAt": "2022-08-12T20:44:48Z",
  "updatedAt": "2022-08-12T20:44:48Z",
  "hasOverlap": true,
  "overlapTimeInSeconds": 1,
  "isDeleted": true,
  "notes": "text",
  "releaseCount": 1,
  "lastSyncedAt": "2022-08-12T20:44:48Z"
}

Deprecated

get

Authorizations

Path parameters

customerIdstring · objectidrequired

customer id

Query parameters

updatedAfterstring · iso-date-timerequired

the date after which the Entry was updated

Example: 2022-08-12T20:44:48Z

updatedOnOrBeforestring · iso-date-timerequired

the date on or before which the Entry was updated

Example: 2022-08-12T20:44:48Z

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/customers/{customerId}/entries?updatedAfter=2022-08-12T20%3A44%3A48Z&updatedOnOrBefore=2022-08-12T20%3A44%3A48Z' \
  --header 'Authorization: Bearer JWT'

200

200

[
  {
    "entryId": "text",
    "externalId": "text",
    "customerId": "text",
    "userId": "text",
    "creationMethod": "async",
    "releasedBy": "text",
    "createdBy": "text",
    "workDate": "2022-08-12",
    "createdAt": "2022-08-12T20:44:48Z",
    "updatedAt": "2022-08-12T20:44:48Z",
    "initiativeExternalId": "text",
    "clientExternalId": "text",
    "summary": "text",
    "unitIncrementCount": 1,
    "incrementDurationInSeconds": 1,
    "lastReleasePendingAt": "2022-08-12T20:44:48Z",
    "lastReleaseFailedAt": "2022-08-12T20:44:48Z",
    "releaseSuccessAt": "2022-08-12T20:44:48Z",
    "isDeleted": true,
    "notes": "text",
    "releaseCount": 1,
    "lastSyncedAt": "2022-08-12T20:44:48Z",
    "codes": [
      {
        "codeExternalId": "text",
        "codeTypeExternalId": "text"
      }
    ]
  }
]

get

Authorizations

Path parameters

customerIdstring · objectidrequired

customer id

Query parameters

updatedAfterstring · iso-date-timerequired

the date after which the Entry was updated

Example: 2022-08-12T20:44:48Z

updatedOnOrBeforestring · iso-date-timerequired

the date on or before which the Entry was updated

Example: 2022-08-12T20:44:48Z

pageSizenumber · int64 · min: 1 · max: 100optional

max number of item in each page

cursorstring · objectidoptional

cursor to start from

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v2/customers/{customerId}/entries?updatedAfter=2022-08-12T20%3A44%3A48Z&updatedOnOrBefore=2022-08-12T20%3A44%3A48Z' \
  --header 'Authorization: Bearer JWT'

200

200

{
  "items": [
    {
      "entryId": "text",
      "externalId": "text",
      "customerId": "text",
      "userId": "text",
      "creationMethod": "async",
      "releasedBy": "text",
      "createdBy": "text",
      "workDate": "2022-08-12",
      "createdAt": "2022-08-12T20:44:48Z",
      "updatedAt": "2022-08-12T20:44:48Z",
      "initiativeExternalId": "text",
      "clientExternalId": "text",
      "summary": "text",
      "unitIncrementCount": 1,
      "incrementDurationInSeconds": 1,
      "lastReleasePendingAt": "2022-08-12T20:44:48Z",
      "lastReleaseFailedAt": "2022-08-12T20:44:48Z",
      "releaseSuccessAt": "2022-08-12T20:44:48Z",
      "isDeleted": true,
      "notes": "text",
      "releaseCount": 1,
      "lastSyncedAt": "2022-08-12T20:44:48Z",
      "codes": [
        {
          "codeExternalId": "text",
          "codeTypeExternalId": "text"
        }
      ]
    }
  ],
  "nextCursor": "text"
}

get

Authorizations

Path parameters

customerIdstring · objectidrequired

customer id

Query parameters

releasedAfterstring · iso-date-timerequired

the date after which the Entry was released

Example: 2022-08-12T20:44:48Z

releasedOnOrBeforestring · iso-date-timerequired

the date on or before which the Entry was released

Example: 2022-08-12T20:44:48Z

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/customers/{customerId}/entries/export?releasedAfter=2022-08-12T20%3A44%3A48Z&releasedOnOrBefore=2022-08-12T20%3A44%3A48Z' \
  --header 'Authorization: Bearer JWT'

200

200

[
  {
    "_id": "text",
    "customerId": "text",
    "userId": "text",
    "workDate": "2022-08-12",
    "summary": "text",
    "unitIncrementCount": 1,
    "incrementDurationInSeconds": 1,
    "initiativeProps": {
      "type": "pms",
      "colorHex": "fec828",
      "tags": [
        "pinned"
      ],
      "nickname": "text",
      "initiative": {
        "type": "pms",
        "_id": "text",
        "billingType": "billable",
        "callSign": "text",
        "unitIncrements": 1,
        "externalId": "text",
        "name": "text",
        "description": "text",
        "client": {
          "_id": "text",
          "externalId": "text",
          "name": "text",
          "description": "text",
          "callSign": "text"
        }
      }
    },
    "externalId": "text",
    "notes": "text",
    "releaseCount": 1,
    "lastSyncedAt": "2022-08-12",
    "codes": [
      {
        "_id": "text",
        "externalId": "text",
        "name": "text",
        "description": "text",
        "type": {
          "_id": "text",
          "externalId": "text",
          "name": "text",
          "semanticType": "action"
        }
      }
    ]
  }
]

get

Authorizations

Path parameters

customerIdstring · objectidrequired

customer id

Query parameters

releasedAfterstring · iso-date-timerequired

the date after which the Entry was released

Example: 2022-08-12T20:44:48Z

releasedOnOrBeforestring · iso-date-timerequired

the date on or before which the Entry was released

Example: 2022-08-12T20:44:48Z

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v2/customers/{customerId}/entries/export?releasedAfter=2022-08-12T20%3A44%3A48Z&releasedOnOrBefore=2022-08-12T20%3A44%3A48Z' \
  --header 'Authorization: Bearer JWT'

200

200

No body

post

Authorizations

Path parameters

customerIdstring · objectidrequired

customer id

Body

requestobject[] · min: 1 · max: 20required

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/customers/{customerId}/entries/release-succeeded/batch' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "request": [
      {
        "entryId": "text",
        "userId": "text",
        "externalId": "text",
        "reReleaseFailedMessages": [
          "text"
        ]
      }
    ]
  }'

207

207

{
  "response": [
    {
      "entryId": "text",
      "status": "CONTINUE",
      "errorMessage": "text",
      "errorCode": 1
    }
  ]
}

post

Authorizations

Path parameters

customerIdstring · objectidrequired

customer's id

userIdstring · objectidrequired

user's id

entryIdstring · objectidrequired

individual entry id

Body

externalIdstringoptional

entry's external id from billing system

reReleaseFailedMessagesstring[]optional

list of errors from re-release attempt

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/customers/{customerId}/users/{userId}/entries/{entryId}/release-succeeded' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "externalId": "text",
    "reReleaseFailedMessages": [
      "text"
    ]
  }'

200

200

No body

post

Authorizations

Path parameters

customerIdstring · objectidrequired

customer's id

userIdstring · objectidrequired

user's id

entryIdstring · objectidrequired

individual entry id

Body

errorsstring[]required

list of errors

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/customers/{customerId}/users/{userId}/entries/{entryId}/release-failed' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "errors": [
      "text"
    ]
  }'

200

200

No body