Update Ticket

You can use this endpoint to update an existing ticket. All fields are optional; only provided fields will be updated.

Request

curl --request PATCH \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/tickets/789' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
  "status": 2,
  "priority": 4,
  "processor_username": "jane.smith",
  "start_date": "2024-11-16"
}'

Optional Fields

All fields are optional. You can update one or multiple fields at once:

• status (integer): Ticket status (1=New, 2=In Process, 3=Done, 4=Rejected, 5=Approved, 8=Billed)
• project_id (integer): Project ID
• project_task_id (string): Project task ID
• priority (integer): Priority from 1 to 5
• subject (string): Ticket subject (max. 255 characters)
• planned_hours (number): Planned hours
• creator_username (string): Creator username
• receipt_date (string): Receipt date (YYYY-MM-DD)
• processor_username (string): Processor username
• start_date (string): Start date (YYYY-MM-DD)
• deadline (string): Deadline (YYYY-MM-DD)
• from_mail (string): Origin email
• external_ticket_number (string): External ticket number (max. 255 characters)
• notify_of_completion (boolean): Notify on completion
• prevent_overbooking (integer): Overbooking prevention (0-4)
• customer_contact_person (string): Customer contact email
• customer_reference (string): Customer reference (max. 255 characters)
• keywords (string): Keywords (max. 255 characters)
• categories (array): Category names

Response

{
	"data": {
		"id": 789,
		"status": 2,
		"project_id": 456,
		"project_task_id": "12",
		"priority": 4,
		"subject": "Fix user interface bug",
		"planned_hours": "8.50",
		"creator_username": "john.doe",
		"receipt_date": "2024-11-15",
		"processor_username": "jane.smith",
		"start_date": "2024-11-16",
		"deadline": "2024-11-20",
		"created": "2024-11-15T10:30:00.000000Z",
		"modified": "2024-11-16T09:15:00.000000Z"
	}
}

Error Codes

• 401 Unauthorized: Invalid or missing authentication
• 404 Not Found: Ticket not found
• 422 Unprocessable Entity: Validation error