# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Unify Tasks API version: 1.0.0 extends: openapi/unify-tasks-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-01' generator: build-phrasing.py label: Generated by API Evangelist operations: 11 - target: $.paths['/tasks/v1/tasks'].get update: x-apievangelist-phrasing: intent: List outreach tasks effect: read questions: - What outreach tasks are assigned to a particular rep? - Can I find all tasks for a contact by their email address? - How do I see open call and LinkedIn tasks sorted by due date? instructions: - text: List tasks assigned to user {assigned_user_id}. slots: assigned_user_id: query.assigned_user_id - text: Show tasks for the person with email {person_email}. slots: person_email: query.person_email - text: List tasks with status {status} sorted by {sort_by}. slots: status: query.status sort_by: query.sort_by method: generated generated: '2026-10-01' - target: $.paths['/tasks/v1/tasks'].post update: x-apievangelist-phrasing: intent: Create an outreach task for a person effect: write questions: - How do I create a call or LinkedIn task for a prospect? - Can I create an email task with a draft subject and body ready to send? instructions: - text: Create a phone call task for this person with a note to follow up. - text: Create a new email task with a draft subject and body for a prospect. method: generated generated: '2026-10-01' - target: $.paths['/tasks/v1/tasks/query-jobs'].get update: x-apievangelist-phrasing: intent: List task export jobs effect: read questions: - Which bulk task export jobs have I started? - Can I filter task export jobs to only the failed ones? instructions: - text: List my task export jobs. - text: Show task export jobs with status {status}. slots: status: query.status method: generated generated: '2026-10-01' - target: $.paths['/tasks/v1/tasks/query-jobs'].post update: x-apievangelist-phrasing: intent: Start a bulk export of tasks effect: write questions: - How do I export every task in bulk instead of paging the task list? - Can I export only the tasks matching a filter? instructions: - text: Start an export job for all tasks. - text: Start a task export filtered by {filter}. slots: filter: requestBody.filter method: generated generated: '2026-10-01' - target: $.paths['/tasks/v1/tasks/query-jobs/{job_id}'].get update: x-apievangelist-phrasing: intent: Check the status of a task export job effect: read questions: - Has my task export job finished? - How long before a task export job expires? instructions: - text: Check the status of task export job {job_id}. slots: job_id: path.job_id - text: Poll task export {job_id} until it is finished. slots: job_id: path.job_id method: generated generated: '2026-10-01' - target: $.paths['/tasks/v1/tasks/query-jobs/{job_id}/cancel'].post update: x-apievangelist-phrasing: intent: Cancel a running task export job effect: destructive questions: - Can I stop a task export that is still in progress? - Which task export jobs are still cancelable? instructions: - text: Cancel task export job {job_id}. slots: job_id: path.job_id - text: Stop the running task export {job_id}. slots: job_id: path.job_id method: generated generated: '2026-10-01' - target: $.paths['/tasks/v1/tasks/query-jobs/{job_id}/results'].get update: x-apievangelist-phrasing: intent: Download results of a task export job effect: read questions: - How do I page through the tasks a finished export returned? - Can I stream exported tasks as newline-delimited JSON? instructions: - text: Fetch the exported tasks from job {job_id}. slots: job_id: path.job_id - text: Get page {page} of task export {job_id} with {page_size} rows. slots: page: query.page job_id: path.job_id page_size: query.page_size method: generated generated: '2026-10-01' - target: $.paths['/tasks/v1/tasks/{id}'].get update: x-apievangelist-phrasing: intent: Get a task by its ID effect: read questions: - How do I look up the details of one specific task? - Can I see who a task is assigned to and when it is due? instructions: - text: Get task {id}. slots: id: path.id - text: Show me the details of task {id}. slots: id: path.id method: generated generated: '2026-10-01' - target: $.paths['/tasks/v1/tasks/{id}'].delete update: x-apievangelist-phrasing: intent: Delete a task effect: destructive questions: - How do I remove a task that was created by mistake? - Can I permanently delete a task instead of completing it? instructions: - text: Delete task {id}. slots: id: path.id - text: Remove the task {id} permanently. slots: id: path.id method: generated generated: '2026-10-01' - target: $.paths['/tasks/v1/tasks/{id}'].patch update: x-apievangelist-phrasing: intent: Reassign, reprioritize or reschedule a task effect: write questions: - How do I reassign a task to another rep or push back its due date? - Can I change a task's priority after it is created? instructions: - text: Reassign task {id} to a different user. slots: id: path.id - text: Change the due date and priority of task {id}. slots: id: path.id method: generated generated: '2026-10-01' - target: $.paths['/tasks/v1/tasks/{id}/complete'].post update: x-apievangelist-phrasing: intent: Mark a task as completed effect: write questions: - How do I mark an outreach task as done? - Can I close out a call task once I've made the call? instructions: - text: Mark task {id} as completed. slots: id: path.id - text: Complete task {id}. slots: id: path.id method: generated generated: '2026-10-01'