Skip to main content
POST
/
worklist
Create a worklist task
curl --request POST \
  --url https://api.autoprintfarm.com/public/v1/worklist \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "subtitle": "<string>",
  "description": "<string>",
  "priority": "medium",
  "printer_id": "<string>",
  "assigned_to": "<string>",
  "estimated_time_minutes": 1,
  "due_date": "2023-11-07T05:31:56Z",
  "apply_default_assignee": true
}
'
{
  "success": true,
  "data": {
    "id": "<string>",
    "title": "<string>",
    "subtitle": "<string>",
    "description": "<string>",
    "task_type": "<string>",
    "priority": "<string>",
    "status": "<string>",
    "printer_id": "<string>",
    "estimated_time_minutes": 123,
    "actual_time_minutes": 123,
    "started_at": "<string>",
    "completed_at": "<string>",
    "due_date": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

Authorizations

Authorization
string
header
required

API keys are minted in the AutoPrintFarm web app under Settings → API Keys. Send as Authorization: Bearer apf_live_.... Keys are shown exactly once at creation and can be revoked at any time.

Body

application/json
title
string
required
Required string length: 1 - 200
task_type
enum<string>
required
Available options:
assembly,
filament_change,
collection,
maintenance,
quality_check
subtitle
string
Maximum string length: 200
description
string
Maximum string length: 2000
priority
enum<string>
default:medium
Available options:
low,
medium,
high
printer_id
string
Minimum string length: 1
assigned_to
string
Minimum string length: 1
estimated_time_minutes
integer
Required range: x >= 0
due_date
string<date-time>

ISO 8601 datetime

apply_default_assignee
boolean

Response

Created

success
enum<boolean>
required
Available options:
true
data
object
required