Deputy · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for Deputy Memo API
39 actions
39 updates
phrasing
extends
openapi/deputy-memo-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 39 · first 16 shown; the file carries all of them
$.info
$.paths['/my/memo'].get
$.paths['/my/memo'].post
$.paths['/my/memo/company/{id}'].get
$.paths['/my/memo/company/{id}'].post
$.paths['/my/memo/reactions/{orm}/{recId}'].get
$.paths['/my/memo/read'].get
$.paths['/my/memo/summary'].get
$.paths['/my/memo/summary'].post
$.paths['/my/memo/team/{id}'].get
$.paths['/my/memo/team/{id}'].post
$.paths['/my/memo/unread'].get
$.paths['/my/memo/user/{id}'].get
$.paths['/my/memo/user/{id}'].post
$.paths['/my/memo/{id}'].get
$.paths['/my/memo/{id}/comment'].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 Memo API
version: 1.0.0
extends: openapi/deputy-memo-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: 38
- target: $.paths['/my/memo'].get
update:
x-apievangelist-phrasing:
intent: List or get my memos
effect: read
questions:
- What memos have I been sent?
- Can I see my own memos?
instructions:
- text: Show my memos.
- text: List the memos I've received.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo'].post
update:
x-apievangelist-phrasing:
intent: Create or update my memos
effect: write
questions:
- How do I create a memo for myself?
- Can I update my own memo?
instructions:
- text: Create or update my memo.
- text: Save a memo for myself.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/company/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get a memo for a company
effect: read
questions:
- What memo is stored for a company?
- Can I fetch a memo by company ID?
instructions:
- text: Get the memo for company {id}.
slots:
id: path.id
- text: Show the memo stored for company {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/company/{id}'].post
update:
x-apievangelist-phrasing:
intent: Create or update a memo for a company
effect: write
questions:
- How do I store a memo for a company?
- Can I update a company's memo?
instructions:
- text: Create or update the memo for company {id}.
slots:
id: path.id
- text: Save a memo against company {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/reactions/{orm}/{recId}'].get
update:
x-apievangelist-phrasing:
intent: Get a memo by ORM and record ID
effect: read
questions:
- Can I fetch a memo using its ORM and record ID?
- What does a memo look like when I have its ORM and record ID?
instructions:
- text: Get the memo with ORM {orm} and record ID {recId}.
slots:
orm: path.orm
recId: path.recId
- text: Show memo {recId} in ORM {orm}.
slots:
orm: path.orm
recId: path.recId
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/read'].get
update:
x-apievangelist-phrasing:
intent: List read memos
effect: read
questions:
- Which memos have I already read?
- Can I see my read memos?
instructions:
- text: List my read memos.
- text: Show the memos I've read.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/summary'].get
update:
x-apievangelist-phrasing:
intent: Get a summary of my memos
effect: read
questions:
- What is a summary of my memos?
- Can I get a quick overview of my memos?
instructions:
- text: Get a summary of my memos.
- text: Summarize my memo activity.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/summary'].post
update:
x-apievangelist-phrasing:
intent: Summarize my memos
effect: read
questions:
- How do I get a summary of my memos?
- Can I refresh my memo summary?
instructions:
- text: Summarize my memos.
- text: Refresh my memo summary.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/team/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get a memo for a team
effect: read
questions:
- What memo is stored for a team?
- Can I fetch a memo by team ID?
instructions:
- text: Get the memo for team {id}.
slots:
id: path.id
- text: Show the memo stored for team {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/team/{id}'].post
update:
x-apievangelist-phrasing:
intent: Create or update a memo for a team
effect: write
questions:
- How do I store a memo for a team?
- Can I update a team's memo?
instructions:
- text: Create or update the memo for team {id}.
slots:
id: path.id
- text: Save a memo against team {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/unread'].get
update:
x-apievangelist-phrasing:
intent: List unread memos
effect: read
questions:
- Which memos have I not read yet?
- Can I see my unread memos?
instructions:
- text: List my unread memos.
- text: Show the memos I haven't read.
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/user/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get a memo for a user
effect: read
questions:
- What memo is stored for a user?
- Can I fetch a memo by user ID?
instructions:
- text: Get the memo for user {id}.
slots:
id: path.id
- text: Show the memo stored for user {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/user/{id}'].post
update:
x-apievangelist-phrasing:
intent: Create or update a memo for a user
effect: write
questions:
- How do I store a memo for a user?
- Can I update a user's memo?
instructions:
- text: Create or update the memo for user {id}.
slots:
id: path.id
- text: Save a memo against user {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get a memo
effect: read
questions:
- Can I fetch a single memo by its ID?
- What does one memo contain?
instructions:
- text: Get memo {id}.
slots:
id: path.id
- text: Show the details of memo {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/{id}/comment'].post
update:
x-apievangelist-phrasing:
intent: Comment on a memo
effect: write
questions:
- How do I comment on a memo?
- Can I reply to a memo?
instructions:
- text: Comment on memo {id}.
slots:
id: path.id
- text: Reply to memo {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/{id}/comment/{commentId}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a comment from my memo
effect: destructive
questions:
- How do I delete a comment I left on one of my memos?
- Can I remove one comment from my memo without deleting the memo itself?
instructions:
- text: Delete comment {commentId} from my memo {id}.
slots:
commentId: path.commentId
id: path.id
- text: Remove comment {commentId} from my own memo {id}.
slots:
commentId: path.commentId
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/{memoId}/mark/read/{memoLogId}'].post
update:
x-apievangelist-phrasing:
intent: Mark a memo read
effect: write
questions:
- How do I mark a memo as read?
- Can I clear a memo from my unread list?
instructions:
- text: Mark memo {memoId} read using log {memoLogId}.
slots:
memoId: path.memoId
memoLogId: path.memoLogId
- text: Mark memo {memoId} as read with log {memoLogId}.
slots:
memoId: path.memoId
memoLogId: path.memoLogId
method: generated
generated: '2026-11-17'
- target: $.paths['/my/memo/{memoId}/mark/unread/{memoLogId}'].post
update:
x-apievangelist-phrasing:
intent: Mark a memo unread
effect: write
questions:
- How do I mark a memo as unread?
- Can I put a memo back on my unread list?
instructions:
- text: Mark memo {memoId} unread using log {memoLogId}.
slots:
memoId: path.memoId
memoLogId: path.memoLogId
- text: Mark memo {memoId} as unread with log {memoLogId}.
slots:
memoId: path.memoId
memoLogId: path.memoLogId
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Memo'].get
update:
x-apievangelist-phrasing:
intent: List Memo records
effect: read
questions:
- Which Memo records can I see?
- Can I list Memo records with pagination?
instructions:
- text: List Memo records.
- text: List Memo records with pagination.
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Memo/INFO'].get
update:
x-apievangelist-phrasing:
intent: Get Memo field metadata
effect: read
questions:
- What fields and associations does the Memo resource have?
- Which Memo fields can I query?
instructions:
- text: Get the field metadata for the Memo resource.
- text: Show which Memo fields are queryable.
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Memo/PREDICT'].post
update:
x-apievangelist-phrasing:
intent: Find the closest existing Memo match
effect: read
questions:
- How do I find an existing Memo record that matches a partial payload?
- Can I predict which Memo an upsert would match before creating it?
instructions:
- text: Predict the existing Memo matching {Id} of type {Type} with confirm text {ConfirmText}.
slots:
Id: requestBody.Id
Type: requestBody.Type
ConfirmText: requestBody.ConfirmText
- text: Find the closest Memo for {Id} titled {Title} with confirm text {ConfirmText}.
slots:
Id: requestBody.Id
Title: requestBody.Title
ConfirmText: requestBody.ConfirmText
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Memo/QUERY'].post
update:
x-apievangelist-phrasing:
intent: Search Memo records
effect: read
questions:
- How do I find Memo records that match a keyword or date range?
- Can I sort Memo search results and include related employees?
instructions:
- text: Search Memo records matching {search}.
slots:
search: requestBody.search
- text: Find Memo records matching {search} sorted by {sort}.
slots:
search: requestBody.search
sort: requestBody.sort
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Memo/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get a Memo by its resource id
effect: read
questions:
- How do I fetch a single Memo from the resource API by its numeric id?
- Can I pull up the full record of one Memo using its id?
instructions:
- text: Fetch the Memo record with numeric id {id}.
slots:
id: path.id
- text: Retrieve resource Memo {id} by its id.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Memo/{id}/COMMENTS'].get
update:
x-apievangelist-phrasing:
intent: List comments on a Memo
effect: read
questions:
- Who has commented on a Memo and what did they say?
- Can I read the comment thread on a Memo?
instructions:
- text: List comments on Memo {id}.
slots:
id: path.id
- text: Show every comment on Memo {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Memo/{id}/COMMENTS'].post
update:
x-apievangelist-phrasing:
intent: Add a comment to a Memo resource
effect: write
questions:
- How do I attach a comment to a Memo through the resource API?
- Can I add a note to a Memo record by its numeric id?
instructions:
- text: Add the comment {Comment} to Memo record {id}.
slots:
Comment: requestBody.Comment
id: path.id
- text: Attach the note {Comment} to the Memo with numeric id {id}.
slots:
Comment: requestBody.Comment
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Memo/{id}/COMMENTS/{commentId}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a comment on a supervisor memo
effect: destructive
questions:
- How do I remove a comment from a supervisor memo?
- Can I delete a comment on a supervisor memo by its comment id?
instructions:
- text: Delete comment {commentId} from supervisor memo {id}.
slots:
commentId: path.commentId
id: path.id
- text: Remove comment {commentId} on memo {id}.
slots:
commentId: path.commentId
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Memo/{id}/HISTORY'].get
update:
x-apievangelist-phrasing:
intent: Get a Memo's change history
effect: read
questions:
- What changes have been made to a Memo over time?
- Can I see the edit history of a Memo record?
instructions:
- text: Show the change history of Memo {id}.
slots:
id: path.id
- text: List every edit made to Memo {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/resource/Memo/{id}/HISTORY/travel/{timestamp}'].get
update:
x-apievangelist-phrasing:
intent: View a Memo as it was at a past time
effect: read
questions:
- How did a Memo look at a specific moment in the past?
- Can I travel back to a Memo's state at a given timestamp?
instructions:
- text: Show Memo {id} as it existed at {timestamp}.
slots:
id: path.id
timestamp: path.timestamp
- text: Travel to Memo {id} at {timestamp} and show it.
slots:
id: path.id
timestamp: path.timestamp
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/memo'].get
update:
x-apievangelist-phrasing:
intent: List or get Memo records
effect: read
questions:
- What Memo records exist in the system?
- Can I list all Memo records?
instructions:
- text: List all Memo records.
- text: Show every Memo record.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/memo'].put
update:
x-apievangelist-phrasing:
intent: Create a Memo record
effect: write
questions:
- How do I create a new Memo record?
- Can I add a Memo with a title and content?
instructions:
- text: Create a new Memo record.
- text: Add a Memo with a title and content.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/memo'].post
update:
x-apievangelist-phrasing:
intent: Create or update a Memo record
effect: write
questions:
- How do I create a Memo or update it if it already exists?
- Can I upsert a Memo record?
instructions:
- text: Create or update the Memo record.
- text: Upsert a Memo record with the given details.
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/memo/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get a memo in the supervise view
effect: read
questions:
- How do I view a memo from the supervisor side?
- Can I open a memo through the supervise endpoint?
instructions:
- text: Get memo {id} from the supervise view.
slots:
id: path.id
- text: Open memo {id} as a supervisor.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/memo/{id}'].put
update:
x-apievangelist-phrasing:
intent: Update a Memo record
effect: write
questions:
- How do I edit an existing Memo record?
- Can I change the title or content of a Memo?
instructions:
- text: Update Memo {id}.
slots:
id: path.id
- text: Edit the existing Memo {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/memo/{id}'].post
update:
x-apievangelist-phrasing:
intent: Respond to a supervisor comment on a memo
effect: write
questions:
- How do I respond to a supervisor comment on a memo?
- Can I post a supervisor comment on a memo?
instructions:
- text: Post a supervisor comment on memo {id}.
slots:
id: path.id
- text: Respond to the supervisor comment on memo {id}.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/memo/{id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a Memo record
effect: destructive
questions:
- How do I delete a Memo record?
- Can I remove a Memo from the system?
instructions:
- text: Delete Memo {id}.
slots:
id: path.id
- text: Remove Memo {id} from the system.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/memo/{id}/addRecipient'].post
update:
x-apievangelist-phrasing:
intent: Add a recipient to a Memo
effect: write
questions:
- How do I add someone as a recipient of a Memo?
- Can I share a Memo with another person?
instructions:
- text: Add a recipient to Memo {id}.
slots:
id: path.id
- text: Share Memo {id} with another person.
slots:
id: path.id
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/memo/{memoId}/mark/read/{memoLogId}'].post
update:
x-apievangelist-phrasing:
intent: Mark a Memo read for a user
effect: write
questions:
- How do I mark a Memo as read for a specific user?
- Can I record that a user has read a Memo?
instructions:
- text: Mark Memo {memoId} read for user {memoLogId}.
slots:
memoId: path.memoId
memoLogId: path.memoLogId
- text: Record user {memoLogId} as having read Memo {memoId}.
slots:
memoLogId: path.memoLogId
memoId: path.memoId
method: generated
generated: '2026-11-17'
- target: $.paths['/supervise/memo/{memoId}/mark/unread/{memoLogId}'].post
update:
x-apievangelist-phrasing:
intent: Mark a Memo unread for a user
effect: write
questions:
- How do I mark a Memo as unread for a user?
- Can I clear a user's read status on a Memo?
instructions:
- text: Mark Memo {memoId} unread for user {memoLogId}.
slots:
memoId: path.memoId
memoLogId: path.memoLogId
- text: Clear user {memoLogId}'s read status on Memo {memoId}.
slots:
memoLogId: path.memoLogId
memoId: path.memoId
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-memo-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.