Entries

PreviousCodes NextInitiatives

Last updated 5 months ago

delete

Authorizations

Path parameters

customerIdstring · objectidRequired

customer's id

userIdstring · objectidRequired

user's id

entryIdstring · objectidRequired

Responses

200Success

application/json

delete

DELETE /api/v1/public/customers/{customerId}/users/{userId}/entries/{entryId} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200Success

{
  "_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",
  "timerDurationAdjustmentInSeconds": 1,
  "complianceRules": [
    {
      "ruleKey": "text",
      "description": "text",
      "enforcementLevel": "block"
    }
  ]
}

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

200Success

application/json

get

GET /api/v1/customers/{customerId}/entries?updatedAfter=2022-08-12T20%3A44%3A48Z&updatedOnOrBefore=2022-08-12T20%3A44%3A48Z HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200Success

[
  {
    "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

200Success

application/json

get

GET /api/v2/customers/{customerId}/entries?updatedAfter=2022-08-12T20%3A44%3A48Z&updatedOnOrBefore=2022-08-12T20%3A44%3A48Z HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200Success

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

200Success

application/json

get

GET /api/v1/customers/{customerId}/entries/export?releasedAfter=2022-08-12T20%3A44%3A48Z&releasedOnOrBefore=2022-08-12T20%3A44%3A48Z HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200Success

[
  {
    "_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

200Success

get

GET /api/v2/customers/{customerId}/entries/export?releasedAfter=2022-08-12T20%3A44%3A48Z&releasedOnOrBefore=2022-08-12T20%3A44%3A48Z HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200Success

No content

post

Authorizations

Path parameters

customerIdstring · objectidRequired

customer's id

userIdstring · objectidRequired

user's id

entryIdstring · objectidRequired

Responses

200Success

post

POST /api/v1/public/customers/{customerId}/users/{userId}/entries/{entryId}/unrelease HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200Success

No content

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

200Success

application/json

patch

PATCH /api/v1/public/customers/{customerId}/users/{userId}/entries/{entryId}/override HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 117

{
  "summary": "text",
  "unitIncrementCountAdjustments": 1,
  "initiativeId": "text",
  "codeIds": [
    "text"
  ],
  "workDate": "2022-08-12"
}

200Success

{
  "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"
    }
  ]
}

post

Authorizations

Path parameters

customerIdstring · objectidRequired

customer id

Body

Responses

207Success

application/json

post

POST /api/v1/customers/{customerId}/entries/release-succeeded/batch HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "request": [
    {
      "entryId": "text",
      "userId": "text",
      "externalId": "text",
      "reReleaseFailedMessages": [
        "text"
      ]
    }
  ]
}

207Success

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

200Success

post

POST /api/v1/customers/{customerId}/users/{userId}/entries/{entryId}/release-succeeded HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "externalId": "text",
  "reReleaseFailedMessages": [
    "text"
  ]
}

200Success

No content

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

200Success

post

POST /api/v1/customers/{customerId}/users/{userId}/entries/{entryId}/release-failed HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "errors": [
    "text"
  ]
}

200Success

No content