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
0Default
0size
Typenumber
Minimum
1Maximum
20Default
10id
assignmentId
typeId
name
startsAt
endsAt
completedAt
confirmedAt
isAllDay
Typeboolean
isOutward
Typeboolean
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
0Default
0size
Typenumber
Minimum
1Maximum
20Default
10id
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
0Default
0size
Typenumber
Minimum
1Maximum
20Default
10id
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"
}