{
  "openapi": "3.0.1",
  "info": {
    "title": "Task Template Builder",
    "description": "Task Template Builder creates reusable SOPs, checklists, project tasks, and automation templates from task titles and goals. It generates steps, subtasks, acceptance criteria, dependencies, tags, roles, time estimates, and automation hints for business workflows.",
    "version": "0.0",
    "x-build-id": "R83zzJwWG7F3uEcse"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/sovanza.inc~task-template-builder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-sovanza.inc-task-template-builder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/sovanza.inc~task-template-builder/runs": {
      "post": {
        "operationId": "runs-sync-sovanza.inc-task-template-builder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/sovanza.inc~task-template-builder/run-sync": {
      "post": {
        "operationId": "run-sync-sovanza.inc-task-template-builder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "tasks"
        ],
        "properties": {
          "tasks": {
            "title": "Tasks",
            "type": "array",
            "description": "List of task requests to turn into reusable templates. Each item should include at least a title or goal.",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "title": "Task Title",
                  "type": "string",
                  "description": "Short name for the task",
                  "editor": "textfield"
                },
                "goal": {
                  "title": "Task Goal",
                  "type": "string",
                  "description": "What the task should accomplish",
                  "editor": "textfield"
                },
                "category": {
                  "title": "Category",
                  "type": "string",
                  "description": "Task category (e.g. sales, marketing, hr, operations, support, content, recruiting, admin)",
                  "editor": "textfield"
                },
                "context": {
                  "title": "Context",
                  "type": "string",
                  "description": "Additional context or notes about the task",
                  "editor": "textfield"
                },
                "priorityHint": {
                  "title": "Priority Hint",
                  "type": "string",
                  "description": "Suggested priority: low, medium, high, urgent",
                  "editor": "textfield"
                },
                "estimatedMinutes": {
                  "title": "Estimated Minutes",
                  "type": "integer",
                  "description": "Optional time estimate in minutes"
                },
                "recurrenceHint": {
                  "title": "Recurrence Hint",
                  "type": "string",
                  "description": "Suggested recurrence: daily, weekly, monthly, after_each_event, one_time, on_new_record",
                  "editor": "textfield"
                },
                "ownerRole": {
                  "title": "Owner Role",
                  "type": "string",
                  "description": "Role of the person responsible (e.g. Sales Rep, HR Manager)",
                  "editor": "textfield"
                },
                "department": {
                  "title": "Department",
                  "type": "string",
                  "description": "Department this task belongs to",
                  "editor": "textfield"
                },
                "inputNotes": {
                  "title": "Input Notes",
                  "type": "string",
                  "description": "Free-form notes about what inputs the task needs",
                  "editor": "textfield"
                }
              }
            }
          },
          "templateMode": {
            "title": "Template Mode",
            "enum": [
              "checklist",
              "sop",
              "project_task",
              "automation_json",
              "hybrid"
            ],
            "type": "string",
            "description": "Style of template to generate. 'hybrid' combines structured JSON with a markdown overview.",
            "default": "hybrid"
          },
          "includeSubtasks": {
            "title": "Include Subtasks",
            "type": "boolean",
            "description": "Generate optional subtask items for each template.",
            "default": true
          },
          "includeAcceptanceCriteria": {
            "title": "Include Acceptance Criteria",
            "type": "boolean",
            "description": "Generate completion conditions for each template.",
            "default": true
          },
          "includeDependencies": {
            "title": "Include Dependencies",
            "type": "boolean",
            "description": "Generate prerequisite dependencies for each template.",
            "default": true
          },
          "includeRecurrenceSuggestion": {
            "title": "Include Recurrence Suggestion",
            "type": "boolean",
            "description": "Suggest a recurrence pattern for each template.",
            "default": true
          },
          "includeAutomationHints": {
            "title": "Include Automation Hints",
            "type": "boolean",
            "description": "Suggest automation opportunities for each template.",
            "default": true
          },
          "includeTimeEstimate": {
            "title": "Include Time Estimate",
            "type": "boolean",
            "description": "Estimate time to complete each task.",
            "default": true
          },
          "includeRoleSuggestion": {
            "title": "Include Role Suggestion",
            "type": "boolean",
            "description": "Suggest an owner role and department for each task.",
            "default": true
          },
          "includeTags": {
            "title": "Include Tags",
            "type": "boolean",
            "description": "Generate descriptive tags for each template.",
            "default": true
          },
          "normalizePriority": {
            "title": "Normalize Priority",
            "type": "boolean",
            "description": "Normalize priority hints into a standard scale (low/medium/high/urgent).",
            "default": true
          },
          "outputStyle": {
            "title": "Output Style",
            "enum": [
              "structured_json",
              "markdown_like",
              "both"
            ],
            "type": "string",
            "description": "Format of the template output. 'both' includes structured JSON and a markdown representation.",
            "default": "both"
          },
          "outputMode": {
            "title": "Output Mode",
            "enum": [
              "dataset",
              "kv_store",
              "both"
            ],
            "type": "string",
            "description": "Where to write results. 'dataset' writes individual rows, 'kv_store' writes a combined export, 'both' does both.",
            "default": "dataset"
          },
          "outputKvStoreKey": {
            "title": "Output KV Store Key",
            "type": "string",
            "description": "Key name used when writing the combined export to the key-value store.",
            "default": "TASK_TEMPLATE_OUTPUT"
          },
          "maxTasks": {
            "title": "Max Tasks",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum number of tasks to process in a single run.",
            "default": 100
          },
          "includeDebugFields": {
            "title": "Include Debug Fields",
            "type": "boolean",
            "description": "Add diagnostic fields (classification reason, inferred signals, warnings) to each output record.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}