Deputy · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Deputy Leave API

24 actions 24 updates phrasing extends openapi/deputy-leave-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 24 · first 16 shown; the file carries all of them

$.info
$.paths['/my/leave'].put
$.paths['/my/leave'].post
$.paths['/my/leave/{strSetup}'].get
$.paths['/resource/Leave'].get
$.paths['/resource/Leave'].put
$.paths['/resource/Leave'].post
$.paths['/resource/Leave/BULK'].post
$.paths['/resource/Leave/INFO'].get
$.paths['/resource/Leave/PREDICT'].post
$.paths['/resource/Leave/QUERY'].post
$.paths['/resource/Leave/{id}'].get
$.paths['/resource/Leave/{id}'].put
$.paths['/resource/Leave/{id}'].post
$.paths['/resource/Leave/{id}'].delete
$.paths['/resource/Leave/{id}/COMMENTS'].get

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 Leave API
  version: 1.0.0
extends: openapi/deputy-leave-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: 23
- target: $.paths['/my/leave'].put
  update:
    x-apievangelist-phrasing:
      intent: Submit leave as the logged-in user
      effect: write
      questions:
      - How does the employee submit their own leave request?
      - Can I create leave through the my/leave endpoint?
      instructions:
      - text: Create leave for the logged-in user.
      - text: Submit my own leave request.
      method: generated
      generated: '2026-11-17'
- target: $.paths['/my/leave'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update leave as the logged-in user
      effect: write
      questions:
      - Can I create or update leave through the my/leave endpoint?
      - What happens if I post leave I already submitted?
      instructions:
      - text: Create or update leave for the logged-in user.
      - text: Submit a leave change as the employee.
      method: generated
      generated: '2026-11-17'
- target: $.paths['/my/leave/{strSetup}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get leave for the logged-in user
      effect: read
      questions:
      - What leave have I already submitted?
      - Can I read my own leave record?
      instructions:
      - text: Get my leave record using setup {strSetup}.
        slots:
          strSetup: path.strSetup
      - text: Show the leave I submitted with setup {strSetup}.
        slots:
          strSetup: path.strSetup
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave'].get
  update:
    x-apievangelist-phrasing:
      intent: List leave records
      effect: read
      questions:
      - Which leave records can I see?
      - Can I list leave for a single employee?
      instructions:
      - text: List my leave records.
      - text: Show all leave records I am allowed to see.
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a leave record
      effect: write
      questions:
      - How do I create a leave record for an employee?
      - Can I set the leave rule and status when creating leave?
      instructions:
      - text: Create leave for employee {Employee} at company {Company} from {Start} to {End} with status {Status}.
        slots:
          Employee: requestBody.Employee
          Company: requestBody.Company
          Start: requestBody.Start
          End: requestBody.End
          Status: requestBody.Status
      - text: Add leave with rule {LeaveRule} and comment {Comment}.
        slots:
          LeaveRule: requestBody.LeaveRule
          Comment: requestBody.Comment
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a leave record
      effect: write
      questions:
      - How do I record a vacation or sick leave for an employee?
      - Can I set a leave as approved when I create it?
      instructions:
      - text: Create leave {id} for {employee} from {start} to {end} with status {status}.
        slots:
          id: requestBody.Id
          employee: requestBody.Employee
          start: requestBody.Start
          end: requestBody.End
          status: requestBody.Status
      - text: Record {days} days of leave for {employee} at {company} starting {date_start} ending {date_end}.
        slots:
          days: requestBody.Days
          employee: requestBody.Employee
          company: requestBody.Company
          date_start: requestBody.DateStart
          date_end: requestBody.DateEnd
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/BULK'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update leave records in bulk
      effect: write
      questions:
      - Can I create many leave records at once?
      - How do I upsert leave for a batch of employees?
      instructions:
      - text: Bulk create or update leave records.
      - text: Upsert a batch of leave records.
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/INFO'].get
  update:
    x-apievangelist-phrasing:
      intent: Get leave field metadata
      effect: read
      questions:
      - Which leave fields can I query or sort on?
      - What field types does the leave resource use?
      instructions:
      - text: Get the field metadata for leave.
      - text: Show which leave fields are queryable.
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/PREDICT'].post
  update:
    x-apievangelist-phrasing:
      intent: Predict a matching leave record
      effect: read
      questions:
      - Can I find an existing leave record before creating one?
      - Which leave record matches a partial leave payload?
      instructions:
      - text: Predict the matching leave record for employee {Employee} from {Start} to {End}.
        slots:
          Employee: requestBody.Employee
          Start: requestBody.Start
          End: requestBody.End
      - text: Find the existing leave record for {Employee} with rule {LeaveRule}.
        slots:
          Employee: requestBody.Employee
          LeaveRule: requestBody.LeaveRule
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/QUERY'].post
  update:
    x-apievangelist-phrasing:
      intent: Search leave records
      effect: read
      questions:
      - Can I search leave by employee or date?
      - How do I sort and page through leave records?
      instructions:
      - text: Search leave for employee {Employee}.
        slots:
          Employee: requestBody.search
      - text: Find leave records sorted by {sort}.
        slots:
          sort: requestBody.sort
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a leave record
      effect: read
      questions:
      - How do I read one leave record by id?
      - What status is a specific leave record in?
      instructions:
      - text: Get leave record {id}.
        slots:
          id: path.id
      - text: Show the status of leave {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a leave record
      effect: write
      questions:
      - How do I update an existing leave record?
      - Can I change the status of a leave record?
      instructions:
      - text: Update leave record {id} to status {Status}.
        slots:
          id: path.id
          Status: requestBody.Status
      - text: Replace leave {id} with start {Start} and end {End}.
        slots:
          id: path.id
          Start: requestBody.Start
          End: requestBody.End
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a leave record
      effect: write
      questions:
      - Can I change the dates or status of an existing leave record?
      - How do I edit leave I already recorded?
      instructions:
      - text: Change leave {id} for {employee} to status {status}.
        slots:
          id: path.id
          employee: requestBody.Employee
          status: requestBody.Status
      - text: Update the comment on leave {id} to {comment}.
        slots:
          id: path.id
          comment: requestBody.Comment
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a leave record
      effect: destructive
      questions:
      - How do I delete a leave record?
      - Can I remove a leave record by id?
      instructions:
      - text: Delete leave record {id}.
        slots:
          id: path.id
      - text: Remove the leave record {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/{id}/COMMENTS'].get
  update:
    x-apievangelist-phrasing:
      intent: List comments on a leave record
      effect: read
      questions:
      - What comments have been left on a leave record?
      - Can I read the comment history of a leave?
      instructions:
      - text: List comments on leave record {id}.
        slots:
          id: path.id
      - text: Show the comment history of leave {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/{id}/COMMENTS'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a comment to a leave record
      effect: write
      questions:
      - How do I comment on a leave record?
      - Can I leave a comment on a leave record?
      instructions:
      - text: Add comment {Comment} to leave record {id}.
        slots:
          Comment: requestBody.Comment
          id: path.id
      - text: Comment on leave {id} saying {Comment}.
        slots:
          id: path.id
          Comment: requestBody.Comment
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/{id}/COMMENTS/{commentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a comment from leave
      effect: destructive
      questions:
      - How do I delete a comment from an employee's leave record?
      - Can I remove an approval comment on leave?
      instructions:
      - text: Delete comment {comment} from leave {id}.
        slots:
          comment: path.commentId
          id: path.id
      - text: Remove the comment {comment} on leave record {id}.
        slots:
          comment: path.commentId
          id: path.id
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/{id}/HISTORY'].get
  update:
    x-apievangelist-phrasing:
      intent: Get change history for a leave record
      effect: read
      questions:
      - Who changed a leave record and when?
      - Can I see the change history of a leave?
      instructions:
      - text: Get the change history of leave record {id}.
        slots:
          id: path.id
      - text: Show who edited leave {id} and when.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-17'
- target: $.paths['/resource/Leave/{id}/HISTORY/travel/{timestamp}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a leave record as it was at a past time
      effect: read
      questions:
      - What did a leave record look like at a past timestamp?
      - Can I travel back to a previous version of a leave?
      instructions:
      - text: Get leave record {id} as it was at {timestamp}.
        slots:
          id: path.id
          timestamp: path.timestamp
      - text: Show leave {id} as it existed on {timestamp}.
        slots:
          id: path.id
          timestamp: path.timestamp
      method: generated
      generated: '2026-11-17'
- target: $.paths['/supervise/leave'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update leave as a supervisor
      effect: write
      questions:
      - Can a supervisor create or update leave for an employee?
      - What happens if I post leave as a supervisor?
      instructions:
      - text: Create or update leave as a supervisor.
      - text: Submit leave on behalf of an employee.
      method: generated
      generated: '2026-11-17'
- target: $.paths['/supervise/leave/leaveManagement'].post
  update:
    x-apievangelist-phrasing:
      intent: Manage leave for a team
      effect: write
      questions:
      - How do I record leave for a team member through the supervisor portal?
      - Can I submit leave requests for my team?
      instructions:
      - text: Submit leave management for my team.
      - text: Record leave requests for the team.
      method: generated
      generated: '2026-11-17'
- target: $.paths['/supervise/leave/{intEmployeeId}'].get
  update:
    x-apievangelist-phrasing:
      intent: View one employee's leave
      effect: read
      questions:
      - What leave has a team member taken?
      - Can I see one employee's leave balance?
      instructions:
      - text: Show leave for employee {intEmployeeId}.
        slots:
          intEmployeeId: path.intEmployeeId
      - text: Get leave history for {intEmployeeId}.
        slots:
          intEmployeeId: path.intEmployeeId
      method: generated
      generated: '2026-11-17'
- target: $.paths['/supervise/leave/{intEmployeeId}/{strSetup}'].get
  update:
    x-apievangelist-phrasing:
      intent: View a leave setup for an employee
      effect: read
      questions:
      - What leave setup is an employee on?
      - Can I see one employee's leave setup?
      instructions:
      - text: Show leave setup {strSetup} for employee {intEmployeeId}.
        slots:
          strSetup: path.strSetup
          intEmployeeId: path.intEmployeeId
      - text: Get the leave setup {strSetup} of {intEmployeeId}.
        slots:
          strSetup: path.strSetup
          intEmployeeId: path.intEmployeeId
      method: generated
      generated: '2026-11-17'

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-leave-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.