memos-api

Generates curl and Python requests for the Memos REST API with authentication and pagination.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/lsongdev/skills --skill memos-api-lsongdev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: memos-api
Source: https://github.com/lsongdev/skills/tree/main/memos-api
Command: npx skills add https://github.com/lsongdev/skills --skill memos-api-lsongdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with the Memos API requires knowing endpoint paths, Bearer token authentication, AIP-160 filter syntax, pagination tokens, and updateMask semantics. This Skill provides ready-to-run request templates and a condensed endpoint reference so you can call, debug, or script against a Memos instance without reading the full API documentation. ## Core Features & Use Cases - Request Generation: Produces curl and Python examples for memo CRUD, attachments, activities, auth, identity providers, resources, and tags. - Pagination & Filtering Guidance: Handles pageSize/pageToken pagination, AIP-160 filter syntax, and partial updates via updateMask. - Batch Operations: Supports batch download scripts and troubleshooting of common API errors like 401/403 and 400 responses. - Use Case: You want to export all public memos from your self-hosted Memos instance. The Skill generates a paginated curl loop with a filter like visibility=PUBLIC, using environment variables for the base URL and token. ## Quick Start Ask the AI to generate a curl command that lists memos from your Memos instance with pagination and a visibility filter, using environment variables for the token.

Frequently Asked Questions about memos-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I call the Memos API with curl?▼

Send requests to https://<your-instance>/api/v1 with an Authorization: Bearer <token> header. For example, list memos with curl -s -H "Authorization: Bearer $MEMOS_TOKEN" "$MEMOS_BASE/api/v1/memos?pageSize=20". Store the token in an environment variable and never print it.

How do I paginate through Memos API list results?▼

Pass pageSize and pageToken query parameters on list endpoints like /memos or /attachments. Read nextPageToken from each response and pass it as pageToken on the next request, repeating until the token is empty.

How do I filter memos using the Memos API filter syntax?▼

The Memos API uses AIP-160 filter syntax in the filter query parameter, such as filter=visibility=PUBLIC or create_time>"2024-01-01T00:00:00Z". Quote string values and use field operator value expressions.

How do I partially update a memo with the Memos API?▼

Send a PATCH request to /api/v1/memos/{memo} with an updateMask query parameter listing the fields to change, such as updateMask=content,visibility. The JSON body only needs to contain the fields named in the mask.

Why does my Memos API request return 401 or 403?▼

A 401 or 403 usually means the Bearer token is missing, expired, or lacks the required scope. Verify the Authorization header is present, refresh the token via POST /auth/refresh, or sign in again with POST /auth/signin.