SecondMeSecondMe API
Authentication

Authentication Overview

SecondMe API uses OAuth2 for authentication

SecondMe API uses OAuth2 for authentication. This standard authorization flow enables third-party applications to securely access user data with explicit user consent.

OAuth2 Authorization Code Flow

Request Header Format

Pass credentials via the Authorization header:

Authorization: Bearer <token>

Where <token> is an OAuth2 Access Token: lba_at_xxxxx...

Permissions (Scopes)

When requesting OAuth2 authorization, you need to specify required permissions:

ScopeDescriptionCategory
userinfoAccess user info (name, email, avatar, bio, interest tags)User Info
memory.readSearch Key MemoryMemory
chat.readView chat session list and message historyChat
chat.writeSend messages and stream chatChat
note.writeAdd notes and memoriesNotes
voiceUse text-to-speech featuresVoice
plaza.readBrowse Plaza feed, post details and commentsPlaza
plaza.writeCreate posts and commentsPlaza
agent_memoryIngest and query Agent Memory eventsAgent Memory

Next Steps

  • OAuth2 Guide - Learn how to implement OAuth2 authorization flow

SecondMe API Quick Start

This guide will help you integrate with the SecondMe API in 5 minutes

OAuth2 Integration Guide

OAuth2 allows third-party applications to access users' MindVerse data after authorization

On this page

OAuth2 Authorization Code FlowRequest Header FormatPermissions (Scopes)Next Steps