Tags help organize memory blobs. Currently, the API supports retrieving tags.

​
Tag Management Endpoints

​
Retrieve Tags

Retrieve a list of all tags available to the specified user. 
GET /tags
Query parameters:
  • user_id (string, required): The unique ID of the user whose tags are being requested.
Example Request: 
curl -X GET "https://api.memoram.app/api/v1/tags?user_id=USER_ID_HERE" \
  -H "Authorization: Bearer YOUR_DEVELOPER_JWT_TOKEN"
Example Response (200 OK): 
{
  "items": [
    {
      "id": "tag_123",
      "name": "preferences",
      "description": "User preferences and settings",
      "color": "#FF5733",
      "is_enabled": true,
      "created_at": "2023-03-15T10:00:00Z",
      "updated_at": "2023-03-15T10:00:00Z"
    },
    {
      "id": "tag_456",
      "name": "work",
      "description": "Work-related memories",
      "color": "#3366FF",
      "is_enabled": true,
      "created_at": "2023-03-16T11:00:00Z",
      "updated_at": "2023-03-16T11:00:00Z"
    }
    // ... other tags
  ]
}

​
Retrieve Single Tag by ID

Retrieve the details of a specific tag by its ID. 
GET /tags/{tagId}
Path parameters:
  • tagId (string, required): The unique ID of the tag.
Query parameters:
  • user_id (string, required): The unique ID of the user who owns the tag.
Example Request: 
curl -X GET "https://api.memoram.app/api/v1/tags/tag_123?user_id=USER_ID_HERE" \
  -H "Authorization: Bearer YOUR_DEVELOPER_JWT_TOKEN"
Example Response (200 OK): A single Tag object (see schema above).