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