馃尶
Laurel APIs
  • Introduction
  • Guides
    • Authentication
    • Building A Connector
    • Public Api Endpoints
  • Services
    • Identity
      • Oauth
      • Users
    • Ingestion
      • Clients
      • Codes
      • Initiatives
      • Validation Rules
    • Time
      • Clients
      • Code Types
      • Codes
      • Entries
      • Initiatives
      • Validation Rules
Powered by GitBook
On this page
  1. Services
  2. Time

Initiatives

PreviousEntriesNextValidation Rules

Last updated 1 year ago

Deprecated
delete
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer id

initiativeExternalIdstringRequired

initiative's external id

Responses
200Success
delete
DELETE /api/v1/customers/{customerId}/initiatives/{initiativeExternalId}/codes HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*
200Success
No content
delete
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer id

initiativeExternalIdstringRequired
codeTypeExternalIdstringRequired
Responses
200Success
delete
DELETE /api/v1/customers/{customerId}/initiatives/{initiativeExternalId}/code-types/{codeTypeExternalId}/codes HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*
200Success
No content
  • POST/api/v1/customers/{customerId}/initiatives/import
  • POST/api/v1/customers/{customerId}/initiatives/{initiativeExternalId}/access
  • DELETE/api/v1/customers/{customerId}/initiatives/{initiativeExternalId}/codes
  • POST/api/v1/customers/{customerId}/initiatives/{initiativeExternalId}/codes
  • POST/api/v2/customers/{customerId}/initiatives/{initiativeExternalId}/codes
  • POST/api/v1/customers/{customerId}/initiatives/{initiativeExternalId}/code-types/{codeTypeExternalId}/codes
  • DELETE/api/v1/customers/{customerId}/initiatives/{initiativeExternalId}/code-types/{codeTypeExternalId}/codes
post
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer id

Body
billingTypestring 路 enumRequired

the billing type for this initiative

Possible values:
externalIdstringRequired

initiative's external id

namestringRequired

a name that identifies this initiative

descriptionstringRequired

the description of the initiative

callSignstringRequired

a short name or abbreviation that identifies this initiative

clientExternalIdstringRequired

external id of client this initiative belongs to

unitIncrementsnumber 路 doubleRequired

unit of billing increments for this initiative in seconds. 36 = 0.01, 360 = 0.1 and 900 = 0.25

statusstring 路 enumOptional

initiative's status

Possible values:
Responses
201Success
post
POST /api/v1/customers/{customerId}/initiatives/import HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 162

{
  "billingType": "billable",
  "externalId": "text",
  "name": "text",
  "description": "text",
  "callSign": "text",
  "clientExternalId": "text",
  "unitIncrements": 1,
  "status": "active"
}
201Success
No content
post
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer id

initiativeExternalIdstringRequired

initiative's external id

Body
typestring 路 enumRequired

type of access.

Possible values:
userIdsstring 路 objectid[]Optional

list of users whose access is either allowed or denied for an initiative.

Responses
201Success
post
POST /api/v1/customers/{customerId}/initiatives/{initiativeExternalId}/access HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "type": "allow",
  "userIds": [
    "text"
  ]
}
201Success
No content
Deprecated
post
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer id

initiativeExternalIdstringRequired

initiative's external id

Body
codeExternalIdsstring[] 路 min: 1 路 max: 2500Required
Responses
201Success
post
POST /api/v1/customers/{customerId}/initiatives/{initiativeExternalId}/codes HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "codeExternalIds": [
    "text"
  ]
}
201Success
No content
Deprecated
post
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer id

initiativeExternalIdstringRequired

initiative's external id

Body
codeExternalIdsstring[] 路 min: 1 路 max: 2500Required
Responses
201Success
post
POST /api/v2/customers/{customerId}/initiatives/{initiativeExternalId}/codes HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "codeExternalIds": [
    "text"
  ]
}
201Success
No content
post
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer id

initiativeExternalIdstringRequired
codeTypeExternalIdstringRequired
Body
codeExternalIdsstring[] 路 min: 1 路 max: 2500Required
Responses
201Success
post
POST /api/v1/customers/{customerId}/initiatives/{initiativeExternalId}/code-types/{codeTypeExternalId}/codes HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "codeExternalIds": [
    "text"
  ]
}
201Success
No content