Deputy · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for Deputy Task API
70 actions
70 updates
phrasing
extends
openapi/deputy-task-api-openapi.yml
Generated by API Evangelist
Written by API Evangelist tooling for Deputy's API. It is a proposal applied on top of the contract, not a document Deputy publishes.
What the actions change
x-apievangelist-phrasing
Targets 70 · first 16 shown; the file carries all of them
$.info
$.paths['/my/task'].get
$.paths['/my/task'].post
$.paths['/my/task/completed'].get
$.paths['/my/task/completed'].post
$.paths['/my/task/department'].get
$.paths['/my/task/department'].post
$.paths['/my/task/department/{date}'].get
$.paths['/my/task/department/{date}'].post
$.paths['/my/task/{id}'].post
$.paths['/my/task/{id}/do'].post
$.paths['/my/task/{id}/undo'].post
$.paths['/resource/Task'].get
$.paths['/resource/Task'].put
$.paths['/resource/Task'].post
$.paths['/resource/Task/BULK'].post
OpenAPI Overlay
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for Deputy Task API
version: 1.0.0
extends: openapi/deputy-task-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-11-17'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 69
- target: $.paths['/my/task'].get
update:
x-apievangelist-phrasing:
intent: List or get my tasks
effect: read
questions:
- What tasks have I been assigned?
- Can I see my own tasks?
instructions:
- text: Show my tasks.
- text: Get the task I'm working on.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/task'].post
update:
x-apievangelist-phrasing:
intent: Create or update my tasks
effect: write
questions:
- How do I create a new task for myself?
- Can I update a task I already have?
instructions:
- text: Create a task for me.
- text: Update my existing task.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/task/completed'].get
update:
x-apievangelist-phrasing:
intent: List my completed tasks
effect: read
questions:
- Which of my tasks have I finished?
- Can I see completed tasks assigned to me?
instructions:
- text: Show my completed tasks.
- text: List the tasks I've finished.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/task/completed'].post
update:
x-apievangelist-phrasing:
intent: Mark one of my tasks as completed
effect: write
questions:
- How do I tick off the task I just finished?
- Can I record completion of a single task?
instructions:
- text: Mark this task as completed.
- text: Record that I finished the task.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/task/department'].get
update:
x-apievangelist-phrasing:
intent: List tasks by department
effect: read
questions:
- What tasks are assigned to a department?
- Can I see department tasks for today?
instructions:
- text: Show tasks for the department.
- text: List department tasks.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/task/department'].post
update:
x-apievangelist-phrasing:
intent: Assign tasks to a department
effect: write
questions:
- How do I assign a task to a department?
- Can I create department tasks?
instructions:
- text: Assign a task to the department.
- text: Create department tasks.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/task/department/{date}'].get
update:
x-apievangelist-phrasing:
intent: List department tasks for a date
effect: read
questions:
- What tasks are assigned to a department on a given day?
- Can I see department tasks for yesterday?
instructions:
- text: Show department tasks for {date}.
slots:
date: path.date
- text: List department tasks on {date}.
slots:
date: path.date
method: generated
generated: '2026-11-17'
- target: $.paths['/my/task/department/{date}'].post
update:
x-apievangelist-phrasing:
intent: Assign department tasks for a date
effect: write
questions:
- How do I assign tasks to a department for a specific day?
- Can I create department tasks for a date?
instructions:
- text: Assign department tasks for {date}.
slots:
date: path.date
- text: Create department tasks on {date}.
slots:
date: path.date
method: generated
generated: '2026-11-17'
- target: $.paths['/my/task/{id}'].post
update:
x-apievangelist-phrasing:
intent: Update a task
effect: write
questions:
- How do I update an existing task?
- Can I change the details of a task?
instructions:
- text: Update task {id}.
slots:
id: path.id
- text: Change the details of task {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/my/task/{id}/do'].post
update:
x-apievangelist-phrasing:
intent: Mark a task as done
effect: write
questions:
- Can I tick a task off my own list?
- What marks my task as done?
instructions:
- text: Mark task {id} as done.
slots:
id: path.id
- text: Tick task {id} on my list.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/my/task/{id}/undo'].post
update:
x-apievangelist-phrasing:
intent: Undo a task
effect: write
questions:
- How do I undo a task I marked done?
- Can I revert a completed task?
instructions:
- text: Undo task {id}.
slots:
id: path.id
- text: Revert the completion of task {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task'].get
update:
x-apievangelist-phrasing:
intent: List my task records
effect: read
questions:
- Which tasks can I see?
- Can I list all my task records?
instructions:
- text: List my task records.
- text: Show every task I'm allowed to see.
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task'].put
update:
x-apievangelist-phrasing:
intent: Create a task record
effect: write
questions:
- How do I create a task record?
- Can I set a task's due date and responsible person?
instructions:
- text: Create task {Question} for {OpUnitId} in group {GroupId} on {Date} with sort order {SortOrder}.
slots:
Question: requestBody.Question
OpUnitId: requestBody.OpUnitId
GroupId: requestBody.GroupId
Date: requestBody.Date
SortOrder: requestBody.SortOrder
- text: Create task {Question} for {OpUnitId} in group {GroupId} on {Date} with sort order {SortOrder}, due {DueDate}, by {UserResponsible}.
slots:
Question: requestBody.Question
OpUnitId: requestBody.OpUnitId
GroupId: requestBody.GroupId
Date: requestBody.Date
SortOrder: requestBody.SortOrder
DueDate: requestBody.DueDate
UserResponsible: requestBody.UserResponsible
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task'].post
update:
x-apievangelist-phrasing:
intent: Create a task
effect: write
questions:
- How do I create a task with a question and answer?
- Can I set who performs a task?
instructions:
- text: Create a task with question {Question} and answer {Answer}.
slots:
Question: requestBody.Question
Answer: requestBody.Answer
- text: Create task {Question} performed by {UserPerformTask}.
slots:
Question: requestBody.Question
UserPerformTask: requestBody.UserPerformTask
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/BULK'].post
update:
x-apievangelist-phrasing:
intent: Bulk create or update tasks
effect: write
questions:
- How do I create many tasks at once?
- Can I update a batch of tasks in one call?
instructions:
- text: Bulk create or update these tasks.
- text: Add this batch of tasks.
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/INFO'].get
update:
x-apievangelist-phrasing:
intent: Get task field metadata
effect: read
questions:
- Which fields can I query on tasks?
- What associations does the task resource have?
instructions:
- text: Get the field metadata for tasks.
- text: Show which task fields are queryable.
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/PREDICT'].post
update:
x-apievangelist-phrasing:
intent: Find an existing task for upserting
effect: read
questions:
- How do I find an existing task before creating it?
- Can I upsert a task by matching its fields?
instructions:
- text: Predict-match an existing task for {Question} on {Date} in group {GroupId}.
slots:
Question: requestBody.Question
Date: requestBody.Date
GroupId: requestBody.GroupId
- text: Find the existing task for {Question} on {Date} in group {GroupId} with sort order {SortOrder}.
slots:
Question: requestBody.Question
Date: requestBody.Date
GroupId: requestBody.GroupId
SortOrder: requestBody.SortOrder
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/QUERY'].post
update:
x-apievangelist-phrasing:
intent: Search tasks
effect: read
questions:
- How do I search tasks by question?
- Can I sort and page through tasks?
instructions:
- text: Search tasks where {search}.
slots:
search: requestBody.search
- text: Find tasks matching {search}, sorted by {sort}, {max} at a time.
slots:
search: requestBody.search
sort: requestBody.sort
max: requestBody.max
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get a task by id
effect: read
questions:
- How do I fetch one task by its id?
- Can I look up a task record?
instructions:
- text: Get task {id}.
slots:
id: path.id
- text: Show me task {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/{id}'].put
update:
x-apievangelist-phrasing:
intent: Replace a task's setup and details
effect: write
questions:
- How do I change a task's setup and details in one update?
- Can I reschedule a task by replacing its setup?
instructions:
- text: Replace task {id} setup with {TaskSetupId}, group {GroupId} and day {DayTimestamp}.
slots:
id: path.id
TaskSetupId: requestBody.TaskSetupId
GroupId: requestBody.GroupId
DayTimestamp: requestBody.DayTimestamp
- text: Recreate task {id} setup {TaskSetupId}, group {GroupId}, day {DayTimestamp}, question {Question}, responsible {UserResponsible}.
slots:
id: path.id
TaskSetupId: requestBody.TaskSetupId
GroupId: requestBody.GroupId
DayTimestamp: requestBody.DayTimestamp
Question: requestBody.Question
UserResponsible: requestBody.UserResponsible
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/{id}'].post
update:
x-apievangelist-phrasing:
intent: Update a task
effect: write
questions:
- Can I change the due date on a task?
- How do I mark a task as completed?
instructions:
- text: Update task {id} with question {Question}, answer {Answer}, due date {DueDate}.
slots:
id: path.id
Question: requestBody.Question
Answer: requestBody.Answer
DueDate: requestBody.DueDate
- text: Mark task {id} as completed.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/{id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a task
effect: destructive
questions:
- Can I delete a task?
- Is deleting a task permanent?
instructions:
- text: Delete task {id}.
slots:
id: path.id
- text: Remove the task with id {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/{id}/COMMENTS'].get
update:
x-apievangelist-phrasing:
intent: List comments on a task
effect: read
questions:
- What comments have been left on a task?
- Can I read the discussion on a task?
instructions:
- text: List comments on task {id}.
slots:
id: path.id
- text: Show the discussion thread for task {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/{id}/COMMENTS'].post
update:
x-apievangelist-phrasing:
intent: Comment on a task
effect: write
questions:
- Can I add a comment to a task?
- How do I leave a note on a task?
instructions:
- text: Comment {Comment} on task {id}.
slots:
Comment: requestBody.Comment
id: path.id
- text: 'Add a note to task {id}: {Comment}.'
slots:
id: path.id
Comment: requestBody.Comment
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/{id}/COMMENTS/{commentId}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a comment on a task
effect: destructive
questions:
- Can I remove a comment from a task?
- Is deleting a task comment permanent?
instructions:
- text: Delete comment {commentId} from task {id}.
slots:
commentId: path.commentId
id: path.id
- text: Remove the comment {commentId} on task {id}.
slots:
commentId: path.commentId
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/{id}/HISTORY'].get
update:
x-apievangelist-phrasing:
intent: Get a task's change history
effect: read
questions:
- Who changed a task and when?
- Can I see the edit history of a task?
instructions:
- text: Show the change history of task {id}.
slots:
id: path.id
- text: List the edits made to task {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Task/{id}/HISTORY/travel/{timestamp}'].get
update:
x-apievangelist-phrasing:
intent: View a task as it was at a past time
effect: read
questions:
- Can I see how a task looked before it was changed?
- What did a task's due date say at a specific moment?
instructions:
- text: Show task {id} as it existed at {timestamp}.
slots:
id: path.id
timestamp: path.timestamp
- text: Travel back to task {id} at {timestamp} and show it.
slots:
id: path.id
timestamp: path.timestamp
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task'].get
update:
x-apievangelist-phrasing:
intent: List or get tasks
effect: read
questions:
- Can I list all my tasks?
- What tasks are assigned to me?
instructions:
- text: List my tasks.
- text: Show every task assigned to me.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task'].put
update:
x-apievangelist-phrasing:
intent: Create a task through the supervise endpoint
effect: write
questions:
- Can I create a task without using the task setup endpoints?
- How do I create a task through the supervise task endpoint?
instructions:
- text: Create a task through the supervise task endpoint.
- text: Use the supervise task create endpoint to set up a new task.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task'].post
update:
x-apievangelist-phrasing:
intent: Create or update a task through supervise
effect: write
questions:
- Is there a supervise task endpoint that creates or updates a task?
- Can supervise create a task if it doesn't exist?
instructions:
- text: Create or update a task through the supervise task endpoint.
- text: Use the supervise task create-or-update endpoint to set up a task.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/QUERY'].post
update:
x-apievangelist-phrasing:
intent: Query tasks through the supervise endpoint
effect: write
questions:
- Can I query tasks through the supervise task endpoint?
- Which supervise task endpoint runs a task query?
instructions:
- text: Query tasks through the supervise task endpoint.
- text: Run a task query using the supervise task query endpoint.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/completed'].get
update:
x-apievangelist-phrasing:
intent: List completed tasks
effect: read
questions:
- Which tasks have been completed?
- Can I see only the tasks I've finished?
instructions:
- text: List completed tasks.
- text: Show the tasks I've marked as done.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/completed'].post
update:
x-apievangelist-phrasing:
intent: Mark tasks as completed
effect: write
questions:
- How do I mark several tasks as completed at once?
- Can I bulk-complete tasks?
instructions:
- text: Mark these tasks as completed.
- text: Bulk-complete the tasks I list.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department'].get
update:
x-apievangelist-phrasing:
intent: List task groups per department
effect: read
questions:
- What task groups are set up for each department?
- Can I see a department's task groups?
instructions:
- text: List the task groups per department.
- text: Show all task groups set up in each department.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department'].post
update:
x-apievangelist-phrasing:
intent: Create a task group in a department
effect: write
questions:
- Can I create a new task group inside one department?
- How do I add a task group to a department?
instructions:
- text: Create a task group in a department.
- text: Add a new task group to this department.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/generate'].post
update:
x-apievangelist-phrasing:
intent: Generate a department task schedule
effect: write
questions:
- Can I generate a schedule of department tasks?
- How do I auto-create a department task roster?
instructions:
- text: Generate a department task schedule.
- text: Auto-create the department task roster.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/schedule'].get
update:
x-apievangelist-phrasing:
intent: Get a department task schedule
effect: read
questions:
- What does the department task schedule look like?
- Can I view a department's task roster?
instructions:
- text: Get the department task schedule.
- text: Show the department task roster.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/task/systemtemplate/copy'].post
update:
x-apievangelist-phrasing:
intent: Copy a system task template
effect: write
questions:
- Can I copy a system task template?
- How do I duplicate a standard task template?
instructions:
- text: Copy the system task template.
- text: Duplicate the standard task template.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/task/systemtemplate/list'].get
update:
x-apievangelist-phrasing:
intent: List system task templates
effect: read
questions:
- Which system task templates exist?
- Can I see the standard task templates?
instructions:
- text: List system task templates.
- text: Show the standard task templates.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/task/{taskid}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a department task
effect: destructive
questions:
- Can I delete a task from a department?
- Is deleting a department task permanent?
instructions:
- text: Delete department task {taskid}.
slots:
taskid: path.taskid
- text: Remove task {taskid} from the department.
slots:
taskid: path.taskid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/taskgroup/{taskgroupid}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a task group
effect: destructive
questions:
- How do I delete a task group from a department?
- Can I remove a task group setup by its ID?
instructions:
- text: Delete task group {taskgroupid} from the department.
slots:
taskgroupid: path.taskgroupid
- text: Remove the task group {taskgroupid} in this department.
slots:
taskgroupid: path.taskgroupid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}'].get
update:
x-apievangelist-phrasing:
intent: List a department's task groups
effect: read
questions:
- What task groups are set up for a department?
- Can I see all task groups in one department?
instructions:
- text: List task groups for department {deptid}.
slots:
deptid: path.deptid
- text: Show every task group in department {deptid}.
slots:
deptid: path.deptid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/apply'].post
update:
x-apievangelist-phrasing:
intent: Apply a task group setup to a department
effect: write
questions:
- How do I apply a task group setup to a department?
- Can I activate a task group setup for a department?
instructions:
- text: Apply the task group setup to department {deptid}.
slots:
deptid: path.deptid
- text: Activate this task group setup in department {deptid}.
slots:
deptid: path.deptid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/create'].post
update:
x-apievangelist-phrasing:
intent: Create a task through a department's create endpoint
effect: write
questions:
- Is there a department-level POST that creates a supervision task?
- Which call creates something new directly under a department's task area?
instructions:
- text: Run the department-level task create POST for department {deptid}.
slots:
deptid: path.deptid
- text: Submit a new supervision task creation under department {deptid}.
slots:
deptid: path.deptid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/date/{strYMD}'].get
update:
x-apievangelist-phrasing:
intent: Get a department's task groups for a date
effect: read
questions:
- What task groups were set up for a department on a given date?
- Can I see a department's task groups for one day?
instructions:
- text: Show task groups for department {deptid} on {strYMD}.
slots:
deptid: path.deptid
strYMD: path.strYMD
- text: Get department {deptid}'s task groups for {strYMD}.
slots:
deptid: path.deptid
strYMD: path.strYMD
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/date/{strYMD}/{strendYMD}'].get
update:
x-apievangelist-phrasing:
intent: Get a department's task groups for a date range
effect: read
questions:
- Which task groups were set up for a department between two dates?
- Can I see a department's task groups for a date range?
instructions:
- text: Show task groups for department {deptid} from {strYMD} to {strendYMD}.
slots:
deptid: path.deptid
strYMD: path.strYMD
strendYMD: path.strendYMD
- text: Get department {deptid}'s task groups between {strYMD} and {strendYMD}.
slots:
deptid: path.deptid
strYMD: path.strYMD
strendYMD: path.strendYMD
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/setup'].get
update:
x-apievangelist-phrasing:
intent: Get a department's task group setup
effect: read
questions:
- What task group setup does a department have?
- Can I view the task group setup of a department?
instructions:
- text: Show the task group setup for department {deptid}.
slots:
deptid: path.deptid
- text: Get department {deptid}'s task group setup.
slots:
deptid: path.deptid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/setup/apply'].post
update:
x-apievangelist-phrasing:
intent: Apply a task group setup in a department
effect: write
questions:
- Can I apply a task group setup to a department?
- What applies a task setup to a department?
instructions:
- text: Apply task group setup {deptid} in department {deptid}.
slots:
deptid: path.deptid
- text: Activate task setup {deptid} for department {deptid}.
slots:
deptid: path.deptid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/setup/create'].put
update:
x-apievangelist-phrasing:
intent: Create a task setup with the PUT setup-create call
effect: write
questions:
- Can I create a setup for a department using a PUT request?
- What does the PUT setup-create call do for a department?
instructions:
- text: Use the PUT setup-create call to create a new setup in department {deptid}.
slots:
deptid: path.deptid
- text: PUT a newly created task setup into department {deptid}.
slots:
deptid: path.deptid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/setup/create'].post
update:
x-apievangelist-phrasing:
intent: Create a task group setup in a department (POST)
effect: write
questions:
- Is there a POST create for a task group setup in a department?
- Can I create a department task setup with a POST?
instructions:
- text: Create task group setup {deptid} in department {deptid} using the POST create.
slots:
deptid: path.deptid
- text: Use the department task setup create POST to add a setup to department {deptid}.
slots:
deptid: path.deptid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/setup/{taskgroupsetupid}'].get
update:
x-apievangelist-phrasing:
intent: Get a task group setup
effect: read
questions:
- What tasks are in a task group setup?
- Can I view one task group setup by its ID?
instructions:
- text: Show task group setup {taskgroupsetupid} in department {deptid}.
slots:
taskgroupsetupid: path.taskgroupsetupid
deptid: path.deptid
- text: Get the tasks in task group setup {taskgroupsetupid} for department {deptid}.
slots:
taskgroupsetupid: path.taskgroupsetupid
deptid: path.deptid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/setup/{taskgroupsetupid}'].post
update:
x-apievangelist-phrasing:
intent: Submit data to a task group setup by its ID
effect: write
questions:
- Can I POST to an existing task group setup using its ID?
- Which call submits changes against one specific task group setup?
instructions:
- text: POST to task group setup {taskgroupsetupid} in department {deptid}.
slots:
taskgroupsetupid: path.taskgroupsetupid
deptid: path.deptid
- text: Submit a request against setup {taskgroupsetupid} belonging to department {deptid}.
slots:
taskgroupsetupid: path.taskgroupsetupid
deptid: path.deptid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/setup/{taskgroupsetupid}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a task group setup from a department
effect: destructive
questions:
- Can I remove a task group setup from a department?
- How do I delete a task setup in a department?
instructions:
- text: Delete task group setup {taskgroupsetupid} from department {deptid}.
slots:
taskgroupsetupid: path.taskgroupsetupid
deptid: path.deptid
- text: Remove task setup {taskgroupsetupid} in department {deptid}.
slots:
taskgroupsetupid: path.taskgroupsetupid
deptid: path.deptid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/setup/{taskgroupsetupid}/apply'].post
update:
x-apievangelist-phrasing:
intent: Apply a chosen task group setup by its ID
effect: write
questions:
- Can I roll out one specific saved setup by its ID in a department?
- Which call applies a chosen setup rather than the department's default?
instructions:
- text: Apply the specific setup {taskgroupsetupid} to department {deptid}.
slots:
taskgroupsetupid: path.taskgroupsetupid
deptid: path.deptid
- text: Put setup {taskgroupsetupid} into effect for department {deptid}.
slots:
taskgroupsetupid: path.taskgroupsetupid
deptid: path.deptid
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/task/department/{deptid}/setup/{taskgroupsetupid}/create'].put
update:
x-apievangelist-phrasing:
intent: Create a task setup within a task group setup (PUT)
effect: write
questions:
- Is there a PUT for creating a task setup inside a task group setup?
- Can I create a task setup in a task group setup with a PUT?
instructions:
- text: Use PUT to create task setup {taskgroupsetupid} in task group setup {taskgroupsetupid} of department {deptid}.
slots:
taskgroupsetupid: path.taskgroupsetupid
deptid: path.deptid
- text: Create task setup {taskgroupsetupid} under task group setup {taskgroupsetupid} in department {deptid} with a PUT.
slots:
taskgroupsetupid: path.taskgroupsetupid
deptid: path.deptid
method: generated
generated: '2026-11-17'
# --- truncated at 32 KB (40 KB total) ---
# Full source: https://artifacts.apis.io/deputy/overlays/deputy-task-api-phrasing-overlay.yaml
Work with this as data
Every overlay here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for openapi overlays
4 MCP tools reach this
find_overlaysBrowse and filter every overlay in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/deputy-task-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.