memos-api

name: memos-api description: | Handles Memos API usage: crafting curl/python requests with Authorization Bearer tokens, paginating with pageSize/pageToken, using filter (AIP-160 syntax), updateMask updates, and mapping common endpoints (memo CRUD, attachments, activities, auth, identity providers). Trigger when user asks to call/inspect/troubleshoot Memos API, generate sample requests, or batch download memos. Warn to avoid printing tokens. compatibility: Requires curl and/or python3. Use env vars for tokens.

Memos API Skill

When to use

• User wants to call Memos API, build curl/python examples, or debug responses
• Needs memo CRUD, attachments, activities, auth/identity providers, or list/filter/pagination
• Needs batch download scripts or reference docs for endpoints

How to use

1. Require base URL and bearer token (env var recommended). Do not print secret values.
2. For list endpoints: support pageSize, pageToken, and filter (AIP-160) if available.
3. For updates: use updateMask=field1,field2 when partial updates are supported.
4. Return ready-to-run curl examples; optionally include python requests snippet.
5. If user needs full endpoint details, load reference file references/memos-api-reference.md.

Quick curl templates

• List memos (example):

  curl -s -H "Authorization: Bearer $MEMOS_TOKEN" \
       "$MEMOS_BASE/api/v1/memos?pageSize=20"
  

• Create memo:

  curl -s -X POST -H "Content-Type: application/json" \
       -H "Authorization: Bearer $MEMOS_TOKEN" \
       "$MEMOS_BASE/api/v1/memos" \
       -d '{"content":"hello"}'
  

• Update memo (partial):

  curl -s -X PATCH -H "Content-Type: application/json" \
       -H "Authorization: Bearer $MEMOS_TOKEN" \
       "$MEMOS_BASE/api/v1/memos/$MEMO_ID?updateMask=content" \
       -d '{"content":"updated"}'
  

• List attachments:

  curl -s -H "Authorization: Bearer $MEMOS_TOKEN" \
       "$MEMOS_BASE/api/v1/attachments?pageSize=20"
  

Bundled references

• references/memos-api-reference.md — full scraped API reference (all services/endpoints).

Notes

• Keep responses concise; link to reference when detailed schemas are needed.
• Use placeholders/env vars ($MEMOS_BASE, $MEMOS_TOKEN, $MEMO_ID) and avoid leaking secrets.
• Prefer curl -s and JSON bodies; add headers only as required.