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

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

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

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.