Tag Management

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).