# Memos API

> Memos API is an Agent Skill for apps & automation published in the OpenMinis/MinisSkills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

- Skill name: `memos-api`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/OpenMinis/MinisSkills/blob/HEAD/memos-api/SKILL.md
- Repository: OpenMinis/MinisSkills (308 GitHub stars when collected)

## SKILL.md

# 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):
  ```sh
  curl -s -H "Authorization: Bearer $MEMOS_TOKEN" \
       "$MEMOS_BASE/api/v1/memos?pageSize=20"
  ```
- Create memo:
  ```sh
  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):
  ```sh
  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:
  ```sh
  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.

---

Source: https://www.openparable.com/skill/apps-automation/memos-api (OpenParable). Cite the canonical URL above.
