Deputy · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for Deputy V2 Timesheet Approval API
32 actions
32 updates
phrasing
extends
openapi/deputy-timesheet-approval-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 32 · first 16 shown; the file carries all of them
$.info
$.paths['/tsa/v2/config-and-permissions'].get
$.paths['/tsa/v2/employees-for-status-grouping'].post
$.paths['/tsa/v2/timesheets'].post
$.paths['/tsa/v2/timesheets/{id}:applicable-range-summary'].get
$.paths['/tsa/v2/timesheets/{id}:approve'].post
$.paths['/tsa/v2/timesheets/{id}:approve-roster'].post
$.paths['/tsa/v2/timesheets/{id}:approve-roster-sync'].post
$.paths['/tsa/v2/timesheets/{id}:approve-sync'].post
$.paths['/tsa/v2/timesheets/{id}:approve-time'].post
$.paths['/tsa/v2/timesheets/{id}:approve-time-roster'].post
$.paths['/tsa/v2/timesheets/{id}:approve-time-roster-sync'].post
$.paths['/tsa/v2/timesheets/{id}:approve-time-sync'].post
$.paths['/tsa/v2/timesheets/{id}:discard'].post
$.paths['/tsa/v2/timesheets/{id}:discard-roster'].post
$.paths['/tsa/v2/timesheets/{id}:end-shift'].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 V2 Timesheet Approval API
version: 1.0.0
extends: openapi/deputy-timesheet-approval-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: 31
- target: $.paths['/tsa/v2/config-and-permissions'].get
update:
x-apievangelist-phrasing:
intent: Check my timesheet permissions
effect: read
questions:
- Which timesheet permissions and config do I have?
- Can I see my timesheet role and settings?
instructions:
- text: Show my timesheet permissions and config.
- text: Get my timesheet role and settings.
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/employees-for-status-grouping'].post
update:
x-apievangelist-phrasing:
intent: List employees by timesheet status
effect: read
questions:
- Which employees have pending timesheets to review?
- Can I group employees by timesheet status for a date range?
instructions:
- text: List employees grouped by timesheet status.
- text: Show employees with pending timesheets first for {dateFrom} to {dateTo}.
slots:
dateFrom: requestBody.dateFrom
dateTo: requestBody.dateTo
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets'].post
update:
x-apievangelist-phrasing:
intent: Create a timesheet
effect: write
questions:
- How do I create a timesheet for a roster?
- Can I mark a new timesheet as discarded or in progress?
instructions:
- text: Create a timesheet for roster {rosterId}.
slots:
rosterId: requestBody.rosterId
- text: Create a timesheet with pay rule approved set to {payRuleApproved}.
slots:
payRuleApproved: requestBody.payRuleApproved
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:applicable-range-summary'].get
update:
x-apievangelist-phrasing:
intent: Summarize timesheets for a date range
effect: read
questions:
- What hours and pay apply to a timesheet over a date range?
- Can I get a range summary for a pay cycle or employee?
instructions:
- text: Get the applicable range summary for timesheet {id}.
slots:
id: path.id
- text: Summarize timesheets for employee {id} over a date range.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:approve'].post
update:
x-apievangelist-phrasing:
intent: Approve a timesheet (pay and time)
effect: write
questions:
- How do I approve a timesheet and override its pay returns?
- Can I approve a timesheet and set answers on it?
instructions:
- text: Approve timesheet {id}.
slots:
id: path.id
- text: Approve timesheet {id} with pay returns {setPayReturns}.
slots:
id: path.id
setPayReturns: requestBody.setPayReturns
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:approve-roster'].post
update:
x-apievangelist-phrasing:
intent: Approve a roster (async)
effect: write
questions:
- Can I approve a roster asynchronously?
- Is there an async version of roster approval?
instructions:
- text: Approve roster {id} asynchronously.
slots:
id: path.id
- text: Approve roster {id} with pay returns {setPayReturns} in the background.
slots:
id: path.id
setPayReturns: requestBody.setPayReturns
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:approve-roster-sync'].post
update:
x-apievangelist-phrasing:
intent: Approve a roster (sync)
effect: write
questions:
- Can I approve a roster and wait for it to finish?
- What does the sync roster approval return?
instructions:
- text: Approve roster {id} and wait for it to complete.
slots:
id: path.id
- text: Sync approve roster {id} with pay returns {setPayReturns}.
slots:
id: path.id
setPayReturns: requestBody.setPayReturns
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:approve-sync'].post
update:
x-apievangelist-phrasing:
intent: Approve a timesheet (sync)
effect: write
questions:
- Can I approve a timesheet and wait for it to finish?
- What does the sync timesheet approval return?
instructions:
- text: Approve timesheet {id} and wait for it to complete.
slots:
id: path.id
- text: Sync approve timesheet {id} with pay returns {setPayReturns}.
slots:
id: path.id
setPayReturns: requestBody.setPayReturns
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:approve-time'].post
update:
x-apievangelist-phrasing:
intent: Time-approve a timesheet (async)
effect: write
questions:
- Can I time-approve a timesheet asynchronously?
- Is there an async version of time-approving a timesheet?
instructions:
- text: Time-approve timesheet {id} asynchronously.
slots:
id: path.id
- text: Time-approve timesheet {id} with answers {setAnswers} in the background.
slots:
id: path.id
setAnswers: requestBody.setAnswers
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:approve-time-roster'].post
update:
x-apievangelist-phrasing:
intent: Approve roster time asynchronously
effect: write
questions:
- Can I approve a roster's timesheet and get a result back immediately?
- Will approving a roster run asynchronously?
instructions:
- text: Time-approve roster {id}.
slots:
id: path.id
- text: Approve roster {id} and set answers {answers}.
slots:
id: path.id
answers: requestBody.setAnswers
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:approve-time-roster-sync'].post
update:
x-apievangelist-phrasing:
intent: Approve roster time synchronously
effect: write
questions:
- What happens if I approve a roster and ask for the result to wait until it's ready?
- Can I sync the roster time approval?
instructions:
- text: Approve roster {id} sync and return the result.
slots:
id: path.id
- text: Sync-time-approve roster {id} with answers {answers}.
slots:
id: path.id
answers: requestBody.setAnswers
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:approve-time-sync'].post
update:
x-apievangelist-phrasing:
intent: Approve a timesheet synchronously
effect: write
questions:
- Can I approve a single timesheet and wait for the approval result?
- What does a sync time-approve of a timesheet return?
instructions:
- text: Time-approve timesheet {id}.
slots:
id: path.id
- text: Sync approve timesheet {id} with answers {answers}.
slots:
id: path.id
answers: requestBody.setAnswers
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:discard'].post
update:
x-apievangelist-phrasing:
intent: Discard a timesheet
effect: destructive
questions:
- How do I discard a timesheet?
- Can I throw away a timesheet I no longer need?
instructions:
- text: Discard timesheet {id}.
slots:
id: path.id
- text: Throw away timesheet {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:discard-roster'].post
update:
x-apievangelist-phrasing:
intent: Discard a roster
effect: destructive
questions:
- How do I discard a roster?
- Can I throw away a roster I no longer need?
instructions:
- text: Discard roster {id}.
slots:
id: path.id
- text: Throw away roster {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:end-shift'].post
update:
x-apievangelist-phrasing:
intent: End a shift
effect: write
questions:
- How do I end a shift on a timesheet?
- Can I close a shift that is still open?
instructions:
- text: End the shift on timesheet {id}.
slots:
id: path.id
- text: Close the open shift for timesheet {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:reapprove'].post
update:
x-apievangelist-phrasing:
intent: Re-approve a timesheet
effect: write
questions:
- How do I re-approve a timesheet I already approved?
- Can I re-approve a timesheet with new answers?
instructions:
- text: Re-approve timesheet {id}.
slots:
id: path.id
- text: Re-approve timesheet {id} with answers {setAnswers}.
slots:
id: path.id
setAnswers: requestBody.setAnswers
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:reinstate'].post
update:
x-apievangelist-phrasing:
intent: Reinstate a discarded timesheet
effect: write
questions:
- How do I bring back a discarded timesheet?
- Can I reinstate a timesheet I discarded earlier?
instructions:
- text: Reinstate discarded timesheet {id}.
slots:
id: path.id
- text: Bring back the discarded timesheet {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:suggest-rounding'].post
update:
x-apievangelist-phrasing:
intent: Suggest rounding for a timesheet
effect: read
questions:
- What rounding would apply to a timesheet's hours?
- Can I suggest rounding for a timesheet with a meal break?
instructions:
- text: Suggest rounding for timesheet {id}.
slots:
id: path.id
- text: Suggest rounding for timesheet {id} with meal break {mealbreak}.
slots:
id: path.id
mealbreak: requestBody.mealbreak
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:unapprove'].post
update:
x-apievangelist-phrasing:
intent: Un-approve a timesheet
effect: destructive
questions:
- How do I un-approve a timesheet?
- Can I take a timesheet back out of time-approved state?
instructions:
- text: Un-approve timesheet {id}.
slots:
id: path.id
- text: Take timesheet {id} out of time-approved state.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:unapprove-pay'].post
update:
x-apievangelist-phrasing:
intent: Unapprove pay on a timesheet
effect: destructive
questions:
- How do I unapprove pay on a timesheet but keep it time-approved?
- Can I undo the pay approval on a timesheet?
instructions:
- text: Unapprove pay on timesheet {id} but leave it time-approved.
slots:
id: path.id
- text: Undo the pay approval for timesheet {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:update'].post
update:
x-apievangelist-phrasing:
intent: Update a timesheet
effect: write
questions:
- How do I edit a timesheet's hours or answers?
- Can I set child timesheets on a timesheet update?
instructions:
- text: Update timesheet {id} with {setProperties}.
slots:
id: path.id
setProperties: requestBody.setProperties
- text: Set child timesheets {setChildTimesheets} on timesheet {id}.
slots:
setChildTimesheets: requestBody.setChildTimesheets
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{id}:validate-update'].post
update:
x-apievangelist-phrasing:
intent: Validate a timesheet update
effect: read
questions:
- Can I check a timesheet update for errors before saving it?
- What validation errors would a timesheet update return?
instructions:
- text: Validate updating timesheet {id} with {setProperties}.
slots:
id: path.id
setProperties: requestBody.setProperties
- text: Preview the errors of setting answers {setAnswers} on timesheet {id}.
slots:
setAnswers: requestBody.setAnswers
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets/{timesheetId}:get-timesheet-questions'].post
update:
x-apievangelist-phrasing:
intent: List a timesheet's questions
effect: read
questions:
- Which questions does a timesheet ask?
- Can I override roster properties when fetching a timesheet's questions?
instructions:
- text: List the questions on timesheet {timesheetId}.
slots:
timesheetId: path.timesheetId
- text: Show timesheet {timesheetId} questions with properties {setProperties}.
slots:
timesheetId: path.timesheetId
setProperties: requestBody.setProperties
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets:batch-approve'].post
update:
x-apievangelist-phrasing:
intent: Approve time and pay for timesheets
effect: write
questions:
- How do I approve time and pay for several timesheets at once?
- Can I approve timesheets matching a query?
instructions:
- text: Approve time and pay for timesheets matching {query}.
slots:
query: requestBody.query
- text: Batch approve all timesheets.
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets:batch-approve-time'].post
update:
x-apievangelist-phrasing:
intent: Time-approve timesheets
effect: write
questions:
- Can I time-approve timesheets asynchronously?
- What does a time-approve batch do to timesheets?
instructions:
- text: Time-approve timesheets matching {query}.
slots:
query: requestBody.query
- text: Asynchronously time-approve all timesheets.
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets:batch-discard'].post
update:
x-apievangelist-phrasing:
intent: Discard timesheets
effect: destructive
questions:
- How do I discard timesheets I no longer need?
- Can I discard timesheets by query?
instructions:
- text: Discard timesheets matching {query}.
slots:
query: requestBody.query
- text: Discard all timesheets.
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets:batch-reinstate'].post
update:
x-apievangelist-phrasing:
intent: Reinstate discarded timesheets
effect: write
questions:
- How do I bring back timesheets I discarded?
- Can I reinstate every discarded timesheet?
instructions:
- text: Reinstate all discarded timesheets.
- text: Restore the timesheets I discarded.
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets:batch-unapprove'].post
update:
x-apievangelist-phrasing:
intent: Unapprove time and pay for timesheets
effect: destructive
questions:
- How do I unapprove time and pay on timesheets?
- Can I undo both time and pay approval in one batch?
instructions:
- text: Unapprove time and pay for timesheets matching {query}.
slots:
query: requestBody.query
- text: Unapprove both time and pay on all timesheets.
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets:batch-unapprove-pay'].post
update:
x-apievangelist-phrasing:
intent: Unapprove pay on timesheets
effect: destructive
questions:
- Can I unapprove pay on timesheets but keep them time-approved?
- What happens to pay approval when I unapprove it?
instructions:
- text: Unapprove pay on timesheets matching {query}.
slots:
query: requestBody.query
- text: Leave time-approved timesheets with pay unapproved.
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/timesheets:validate'].post
update:
x-apievangelist-phrasing:
intent: Validate a timesheet creation
effect: read
questions:
- Can I check a new timesheet for errors before creating it?
- What validation does a new timesheet creation run?
instructions:
- text: Validate a new timesheet with {setProperties}.
slots:
setProperties: requestBody.setProperties
- text: Check creating a timesheet on roster {rosterId} with {setAnswers}.
slots:
rosterId: requestBody.rosterId
setAnswers: requestBody.setAnswers
method: generated
generated: '2026-11-17'
- target: $.paths['/tsa/v2/{parent}/comments'].post
update:
x-apievangelist-phrasing:
intent: Comment on a timesheet
effect: write
questions:
- How do I add a comment to a timesheet?
- Can I leave a comment on a timesheet as a specific user?
instructions:
- text: Comment {content} on {parent}.
slots:
content: requestBody.content
parent: path.parent
- text: Add a comment {content} to {parent} as {creator}.
slots:
content: requestBody.content
parent: path.parent
creator: requestBody.creator
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-timesheet-approval-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.