GET
/
api
/
v3
/
workcycleExceptions
curl --request GET \
  --url https://{account}-{sandboxName}.sandbox.{server}.luccasoftware.com/api/v3/workcycleExceptions
{
  "data": {
    "count": 1,
    "items": [
      {
        "id": 2,
        "name": "<string>",
        "url": "<string>",
        "ownerId": 2,
        "owner": {
          "id": 2,
          "name": "<string>",
          "url": "<string>",
          "firstName": "<string>",
          "lastName": "<string>"
        },
        "isAm": true,
        "unit": "day",
        "startsAt": "2023-11-07T05:31:56Z",
        "endsAt": "2023-11-07T05:31:56Z",
        "durationInMinutes": 1,
        "duration": "<string>",
        "authorId": 1,
        "createdAt": "2023-11-07T05:31:56Z",
        "modifierId": 1,
        "modifiedAt": "2023-11-07T05:31:56Z",
        "deletedById": 1,
        "deletedAt": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

Query Parameters

​
fields
enum<string>[]

List the properties you want included in the response. Example: ?fields=id,ownerId,isAm,startsAt,duration,unit,createdAt,modifiedAt,deletedAt,collection.count

The collection.count field indicates the total number of items across all pages.

Available options:
id,
name,
url,
ownerId,
owner.id,
owner.name,
owner.url,
owner.firstName,
owner.lastName,
isAm,
unit,
startsAt,
endsAt,
durationInMinutes,
duration,
authorId,
createdAt,
modifierId,
modifiedAt,
deletedById,
deletedAt,
collection.count
​
id
integer[]

Retrieve WorkCycleExceptions that match one of the given IDs (comma separated list).

​
ownerId
integer[]

Only retrieve WorkCycleExceptions that apply to one of the given employees, identified by their ID (comma separated list of int).

​
isAm
boolean

Filter on the isAm property.

  • true: the workcycleException applies to the first half-day.
  • false: the workcycleException applies to the second half-day. Omit this query parameter in order to retrieve all workcycleExceptions, whether they apply to the first or the second half-day.
​
startsAt
string

Only retrieve items that match the given date condition.

  • ?startsAt=between,{date1},{date2}: items that intersect the {date1}- {date2} period.
  • ?startsAt=since,{date}: items that occur after (non-strict) the given {date}.
  • ?startsAt=until,{date}: items that occur before (non-strict) the given {date}.
​
deletedAt
enum<string>
  • null (default): do no include deleted WorkCycleExceptions.
  • notequal,null: only retrieve deleted WorkCycleExceptions.
  • no param: retrieve both deleted and non-deleted WorkCycleExceptions.
Available options:
notequal,null,
null
​
unit
enum<integer>

Only retrieve WorkCycleExceptions whose unit match one of the given.

Available options:
0,
1,
2
​
paging
string

Syntax: {index},{pageSize} Index is the position of the first item to retrieve. PageSize is the number of items per page. Note: Page size cannot exceed 1,000. For example, to retrieve the first 100 items: ?paging=0,100, then to retrieve the 100 next: ?paging:100,100

​
orderBy
enum<string>[]

Sort items by ascending or descending property value. Syntax is: {propertyName},{direction} where direction can either be asc (ascending) or desc (descending).

Available options:
id,asc,
id,desc,
startsAt,asc,
startsAt,desc

Response

200
application/json
OK
​
data
object

Was this page helpful?

The workcycle-exception resourceCreate (or update) a WorkCycleException.