Appearance
AssignmentEvent
The AssignmentEvents within an Assignment. AssignmentEvents are the central part of Artesa. AssignmentEvents can be scheduled, are used for time tracking and are the entry point for calculation.
Operations
GET/v1/assignment-events/specGET/v1/assignment-eventsPOST/v1/assignment-eventsGET/v1/assignment-events/{assignmentEventId}DELETE/v1/assignment-events/{assignmentEventId}PATCH/v1/assignment-events/{assignmentEventId}GET/v1/assignment-events/{assignmentEventId}/uploadsPOST/v1/assignment-events/{assignmentEventId}/uploadsGET/v1/assignment-events/{assignmentEventId}/uploads/{uploadId}DELETE/v1/assignment-events/{assignmentEventId}/uploads/{uploadId}PATCH/v1/assignment-events/{assignmentEventId}/uploads/{uploadId}
OpenAPI Spec
List AssignmentEvents
GET
/v1/assignment-events
List AssignmentEvents
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Query Parameters
page
Typenumber
Minimum
0
Default
0
size
Typenumber
Minimum
1
Maximum
20
Default
10
name
typeId
startsAt
endsAt
completedAt
confirmedAt
isAllDay
Typeboolean
isOutward
Typeboolean
assignmentId
externalId
createdAt
updatedAt
Responses
List response
application/json
{
"page": 0,
"pages": 0,
"size": 10,
"items": [
{
"id": 0,
"name": "string",
"startsAt": "string",
"endsAt": "string",
"plannedEmployeeCount": 0,
"workingTimePerDay": 0,
"completedAt": "string",
"confirmedAt": "string",
"note": "string",
"order": 0,
"isAllDay": true,
"isOutward": true,
"externalId": "string",
"workDays": 0,
"manPower": 0,
"typeId": 0,
"assignmentId": 0,
"groupId": 0,
"assignedUsers": [
0
],
"assignedGangs": [
0
],
"addressStartFrom": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"addressDestination": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"addressReturnTo": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"createdAt": "string",
"updatedAt": "string"
}
]
}
Create a new AssignmentEvent
POST
/v1/assignment-events
Create a new AssignmentEvent
Authorizations
apiKey
TypeHTTP (bearer)
Request Body
application/json
{
"name": null,
"startsAt": null,
"endsAt": null,
"plannedEmployeeCount": 0,
"workDays": 0,
"workingTimePerDay": 0,
"manPower": 0,
"completedAt": true,
"confirmedAt": true,
"note": null,
"order": 0,
"isAllDay": true,
"isOutward": true,
"externalId": null,
"assignmentId": 0,
"typeId": 0,
"groupId": null,
"assignedUsers": [
0
],
"assignedGangs": [
0
],
"addressStartFrom": "string",
"addressDestination": "string",
"addressReturnTo": "string"
}
Responses
AssignmentEvent found
application/json
{
"id": 0,
"name": "string",
"startsAt": "string",
"endsAt": "string",
"plannedEmployeeCount": 0,
"workingTimePerDay": 0,
"completedAt": "string",
"confirmedAt": "string",
"note": "string",
"order": 0,
"isAllDay": true,
"isOutward": true,
"externalId": "string",
"workDays": 0,
"manPower": 0,
"typeId": 0,
"assignmentId": 0,
"groupId": 0,
"assignedUsers": [
0
],
"assignedGangs": [
0
],
"addressStartFrom": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"addressDestination": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"addressReturnTo": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"createdAt": "string",
"updatedAt": "string"
}
Get an AssignmentEvent
GET
/v1/assignment-events/{assignmentEventId}
Get an AssignmentEvent by ID
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
Responses
AssignmentEvent found
application/json
{
"id": 0,
"name": "string",
"startsAt": "string",
"endsAt": "string",
"plannedEmployeeCount": 0,
"workingTimePerDay": 0,
"completedAt": "string",
"confirmedAt": "string",
"note": "string",
"order": 0,
"isAllDay": true,
"isOutward": true,
"externalId": "string",
"workDays": 0,
"manPower": 0,
"typeId": 0,
"assignmentId": 0,
"groupId": 0,
"assignedUsers": [
0
],
"assignedGangs": [
0
],
"addressStartFrom": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"addressDestination": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"addressReturnTo": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"createdAt": "string",
"updatedAt": "string"
}
Delete an AssignmentEvent
Update an AssignmentEvent
PATCH
/v1/assignment-events/{assignmentEventId}
Update an AssignmentEvent by ID
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
Request Body
application/json
{
"name": "string",
"startsAt": "string",
"endsAt": "string",
"plannedEmployeeCount": 0,
"workDays": 0,
"workingTimePerDay": 0,
"manPower": 0,
"completedAt": true,
"confirmedAt": true,
"note": "string",
"order": 0,
"isAllDay": true,
"isOutward": true,
"externalId": "string",
"groupId": 0,
"assignedUsers": [
0
],
"assignedGangs": [
0
],
"addressStartFrom": "string",
"addressDestination": "string",
"addressReturnTo": "string"
}
Responses
AssignmentEvent found
application/json
{
"id": 0,
"name": "string",
"startsAt": "string",
"endsAt": "string",
"plannedEmployeeCount": 0,
"workingTimePerDay": 0,
"completedAt": "string",
"confirmedAt": "string",
"note": "string",
"order": 0,
"isAllDay": true,
"isOutward": true,
"externalId": "string",
"workDays": 0,
"manPower": 0,
"typeId": 0,
"assignmentId": 0,
"groupId": 0,
"assignedUsers": [
0
],
"assignedGangs": [
0
],
"addressStartFrom": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"addressDestination": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"addressReturnTo": {
"supplement": "string",
"street": "string",
"clarification": "string",
"zip": "string",
"city": "string",
"state": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"externalId": "string",
"link": "string"
},
"createdAt": "string",
"updatedAt": "string"
}
List all uploads for an assignment event
GET
/v1/assignment-events/{assignmentEventId}/uploads
List all uploads for a specific assignment event.
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
Query Parameters
page
Typenumber
Minimum
0
Default
0
size
Typenumber
Minimum
1
Maximum
20
Default
10
categoryId
Responses
List response
application/json
{
"page": 0,
"pages": 0,
"size": 10,
"items": [
{
"id": 0,
"mimeType": "string",
"fileSize": 0,
"fileName": "string",
"description": "string",
"downloadUrl": "string",
"categoryId": 0,
"createdAt": "string",
"updatedAt": "string",
"assignmentEventId": 0,
"additionalProperties": "string"
}
]
}
Create a new assignment event upload
POST
/v1/assignment-events/{assignmentEventId}/uploads
Create a new upload for an assignment event. The file must be provided as multipart/form-data.
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
Request Body
multipart/form-data
object
file
string
Required
Format
"binary"
categoryId
integer
description
string
Responses
AssignmentEvent upload found
application/json
{
"id": 0,
"mimeType": "string",
"fileSize": 0,
"fileName": "string",
"description": "string",
"downloadUrl": "string",
"categoryId": 0,
"createdAt": "string",
"updatedAt": "string",
"assignmentEventId": 0,
"additionalProperties": "string"
}
Get a specific upload for an assignment event
GET
/v1/assignment-events/{assignmentEventId}/uploads/{uploadId}
Get a specific upload for an assignment event by its ID.
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
uploadId*
Typeinteger
RequiredFormat
"int32"
Responses
AssignmentEvent upload found
application/json
{
"id": 0,
"mimeType": "string",
"fileSize": 0,
"fileName": "string",
"description": "string",
"downloadUrl": "string",
"categoryId": 0,
"createdAt": "string",
"updatedAt": "string",
"assignmentEventId": 0,
"additionalProperties": "string"
}
Delete a specific upload for an assignment event
DELETE
/v1/assignment-events/{assignmentEventId}/uploads/{uploadId}
Delete a specific upload for an assignment event by its ID.
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
uploadId*
Typeinteger
RequiredFormat
"int32"
Responses
Successfully removed
Update a specific upload for an assignment event
PATCH
/v1/assignment-events/{assignmentEventId}/uploads/{uploadId}
Update a specific upload for an assignment event by its ID.
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
uploadId*
Typeinteger
RequiredFormat
"int32"
Request Body
application/json
{
"description": "string",
"categoryId": 0,
"fileName": "string"
}
Responses
AssignmentEvent upload found
application/json
{
"id": 0,
"mimeType": "string",
"fileSize": 0,
"fileName": "string",
"description": "string",
"downloadUrl": "string",
"categoryId": 0,
"createdAt": "string",
"updatedAt": "string",
"assignmentEventId": 0,
"additionalProperties": "string"
}
List all uploads for an assignment event
GET
/v1/assignment-events/{assignmentEventId}/uploads
List all uploads for a specific assignment event.
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
Query Parameters
page
Typenumber
Minimum
0
Default
0
size
Typenumber
Minimum
1
Maximum
20
Default
10
categoryId
Responses
List response
application/json
{
"page": 0,
"pages": 0,
"size": 10,
"items": [
{
"id": 0,
"mimeType": "string",
"fileSize": 0,
"fileName": "string",
"description": "string",
"downloadUrl": "string",
"categoryId": 0,
"createdAt": "string",
"updatedAt": "string",
"assignmentEventId": 0,
"additionalProperties": "string"
}
]
}
Create a new assignment event upload
POST
/v1/assignment-events/{assignmentEventId}/uploads
Create a new upload for an assignment event. The file must be provided as multipart/form-data.
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
Request Body
multipart/form-data
object
file
string
Required
Format
"binary"
categoryId
integer
description
string
Responses
AssignmentEvent upload found
application/json
{
"id": 0,
"mimeType": "string",
"fileSize": 0,
"fileName": "string",
"description": "string",
"downloadUrl": "string",
"categoryId": 0,
"createdAt": "string",
"updatedAt": "string",
"assignmentEventId": 0,
"additionalProperties": "string"
}
Get a specific upload for an assignment event
GET
/v1/assignment-events/{assignmentEventId}/uploads/{uploadId}
Get a specific upload for an assignment event by its ID.
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
uploadId*
Typeinteger
RequiredFormat
"int32"
Responses
AssignmentEvent upload found
application/json
{
"id": 0,
"mimeType": "string",
"fileSize": 0,
"fileName": "string",
"description": "string",
"downloadUrl": "string",
"categoryId": 0,
"createdAt": "string",
"updatedAt": "string",
"assignmentEventId": 0,
"additionalProperties": "string"
}
Delete a specific upload for an assignment event
DELETE
/v1/assignment-events/{assignmentEventId}/uploads/{uploadId}
Delete a specific upload for an assignment event by its ID.
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
uploadId*
Typeinteger
RequiredFormat
"int32"
Responses
Successfully removed
Update a specific upload for an assignment event
PATCH
/v1/assignment-events/{assignmentEventId}/uploads/{uploadId}
Update a specific upload for an assignment event by its ID.
Authorizations
apiKey
TypeHTTP (bearer)
Parameters
Path Parameters
assignmentEventId*
Typeinteger
RequiredFormat
"int32"
uploadId*
Typeinteger
RequiredFormat
"int32"
Request Body
application/json
{
"description": "string",
"categoryId": 0,
"fileName": "string"
}
Responses
AssignmentEvent upload found
application/json
{
"id": 0,
"mimeType": "string",
"fileSize": 0,
"fileName": "string",
"description": "string",
"downloadUrl": "string",
"categoryId": 0,
"createdAt": "string",
"updatedAt": "string",
"assignmentEventId": 0,
"additionalProperties": "string"
}