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.
View Overlay File View on GitHub Overlay Specification

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

Raw ↑
# 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.
All 92 tools →

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.