Mem external-v2 API
The external-v2 API from Mem — 44 operation(s) for external-v2.
Mem external-v2 API is one of 5 APIs that Mem publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include external-v2. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, rate-limit docs, and a changelog.
This API exposes 54 operations across 44 paths, and defines 229 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.
Requests are made against a single base URL, https://api.mem.ai.
54 operations
44 paths
229 schemas
4 DELETE22 GET4 PATCH22 POST2 PUT
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 3
Mem external-v2 API declares
3 security schemes
for authenticating requests.
It accepts HTTP bearer tokens (bearerAuth).
An API key is passed in the query as token (CoreApi__AssetAccessToken).
An API key is passed in the header as Authorization (CoreApi__Authorization).
By default, every request must be authenticated.
Paths & Operations 54
Across 44 paths, the API surfaces 54 operations — 4 DELETE, 22 GET, 4 PATCH, 22 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.
external-v2 54
POST
/v2/attachments/answer-question
Answer Question About Attachment
POST
/v2/attachments/read
Read Attachment
GET
/v2/audio-recordings/{audio_recording_id}
Read Audio Recording
GET
/v2/calendar/calendars
List Calendars
POST
/v2/calendar/calendars/settings
Update Calendar Settings
GET
/v2/calendar/connections
List Calendar Connections
POST
/v2/calendar/connections/{provider}/callback
Calendar Oauth Callback
POST
/v2/calendar/connections/{provider}/connect
Connect Calendar
POST
/v2/calendar/connections/{provider}/disconnect
Disconnect Calendar
GET
/v2/calendar/events
List Calendar Events
GET
/v2/calendar/events/{event_id}
Read Calendar Event
POST
/v2/calendar/reconcile
Reconcile Calendar
GET
/v2/collections
List Collections
POST
/v2/collections
Create Collection
DELETE
/v2/collections/{collection_id}
Delete Collection
GET
/v2/collections/{collection_id}
Read Collection
PATCH
/v2/collections/{collection_id}
Update Collection
DELETE
/v2/collections/{collection_id}/notes/{note_id}
Remove Note From Collection
PUT
/v2/collections/{collection_id}/notes/{note_id}
Add Note To Collection
POST
/v2/collections/{source_collection_id}/notes/{note_id}/move
Move Note
POST
/v2/collections/search
Search Collections
GET
/v2/event-types
List Event Types
GET
/v2/events
List Events
GET
/v2/events/{event_id}
Read Event
GET
/v2/follow-ups
List Follow Ups
GET
/v2/follow-ups/{follow_up_id}
Read Follow Up
POST
/v2/mcp/chatgpt/fetch
Fetch Resources
POST
/v2/mcp/chatgpt/search
Search Resources
POST
/v2/mcp/initialize
Initialize Mcp
GET
/v2/mcp/notes/{note_id}
View Note
POST
/v2/mcp/notes/search
Search Notes
POST
/v2/mem-it
Mem It
GET
/v2/note-attachments/{attachment_id}/download-url
Get Note Attachment Download Url
GET
/v2/notes
List Notes
POST
/v2/notes
Create Note
DELETE
/v2/notes/{note_id}
Delete Note
GET
/v2/notes/{note_id}
Read Note
PATCH
/v2/notes/{note_id}
Update Note
PATCH
/v2/notes/{note_id}/created-at
Set Note Created At
GET
/v2/notes/{note_id}/related-notes
Find Related Notes
POST
/v2/notes/{note_id}/restore
Restore Note
POST
/v2/notes/{note_id}/trash
Trash Note
POST
/v2/notes/extended-search
Extended Search Notes
POST
/v2/notes/search
Search Notes
GET
/v2/projects
List Projects
GET
/v2/projects/{project_id}
Read Project
POST
/v2/session-events/search
Search Session Events
POST
/v2/sessions
Create Session
DELETE
/v2/sessions/{session_id}
Delete Session
GET
/v2/sessions/{session_id}
Read Session
PATCH
/v2/sessions/{session_id}
Update Session
PUT
/v2/sessions/{session_id}
Upsert Session
GET
/v2/tasks
List Tasks
GET
/v2/tasks/{task_id}
Read Task
Schemas 229
The contract defines 229 schemas that model the data the API accepts and returns. The most detailed are NoteUpdatedV1ArtifactPayload (23 properties), FollowUpResponseItemSchema (17 properties), NoteCreatedV1ArtifactPayload (17 properties), EmailAttachmentResponseSchema (16 properties). Each schema is shown below with its type and property counts.
AnswerQuestionAboutAttachmentResponseSchema
object
5 properties
4 required
CalendarOAuthCallbackResponseSchema
object
3 properties
3 required
CreateSessionRequestSchema
object
6 properties
ListCalendarEventsResponseSchema
object
3 properties
3 required
AgentCollectionSearchResultModel
object
3 properties
2 required
MessageUserToolCallArgs
object
1 property
1 required
ProjectResponseItemSchema
object
7 properties
7 required
UpdateCalendarSettingsRequestSchema
object
3 properties
3 required
NoteResultsConfigSchema
object
1 property
TrashNoteToolCallArgs
object
1 property
1 required
ListCalendarConnectionsResponseSchema
object
2 properties
2 required
UpdateSessionRequestSchema
object
5 properties
WebClipExternalInputPayload
object
2 properties
1 required
SessionEventUserMessageEventDataSchema
object
2 properties
2 required
SearchSessionEventsRequestSchema
object
3 properties
1 required
RenameCollectionToolCallResult
object
2 properties
1 required
CollectionListResponseSchema
object
4 properties
3 required
ReadEventResponseSchema
object
8 properties
8 required
SessionKind
string
DeleteCollectionResponseSchema
object
1 property
1 required
GetNoteAttachmentDownloadUrlResponseSchema
object
3 properties
3 required
AddNoteToCollectionResponseSchema
object
1 property
1 required
FindRelatedNotesResponseSchema
object
3 properties
3 required
DeleteCollectionToolCallArgs
object
1 property
1 required
ReconcileCalendarRequestSchema
object
3 properties
2 required
TaskStatusInput
string
TextSessionPart
object
3 properties
1 required
ReadAttachmentRequestSchema
object
6 properties
2 required
ViewImageToolCallArgs
object
1 property
1 required
SetNoteCreatedAtResponseSchema
object
9 properties
9 required
ReadNoteResponseSchema
object
11 properties
11 required
FetchChatGPTResponseSchema
object
1 property
1 required
ToolCallOrigin
string
Indicates who initiated a tool call. MODEL: The AI model requested this tool call as part of its response. USER: The system initiated this call on behalf of th…
CreateCollectionRequestSchema
object
5 properties
1 required
CalendarOAuthCallbackRequestSchema
object
5 properties
2 required
AgentCollectionModel
object
6 properties
5 required
FactCardV1SessionPart
object
6 properties
4 required
SessionEventAgentActionV1EventDataSchema
object
2 properties
2 required
CreateFactCardToolCallArgs
object
3 properties
3 required
TaskResponseItemSchema
object
8 properties
8 required
QuotaLimitReachedNotificationPayload
object
3 properties
2 required
CollectionChipSessionPartPayload
object
3 properties
2 required
RelatedNoteItemResponseSchema
object
9 properties
7 required
SearchForCollectionsToolCallArgs
object
3 properties
ReadCollectionResponseSchema
object
7 properties
7 required
ExtendedSearchNotesResponseSchema
object
4 properties
3 required
CreateNoteToolCallResult
object
3 properties
1 required
AddNoteToCollectionToolCallArgs
object
2 properties
2 required
AgentNoteModel
object
11 properties
6 required
AttachmentPdfPageResponseSchema
object
5 properties
1 required
CalendarItemSchema
object
9 properties
3 required
UsageQuotaExceededDetails
object
6 properties
4 required
AttachmentMatchInfoForAgent
object
7 properties
3 required
SearchNotesResponseSchema
object
4 properties
3 required
ReadCalendarEventResponseSchema
object
2 properties
2 required
ExtendedSearchAttachmentMatchResponseSchema
object
16 properties
2 required
MemItRequestSchema
object
4 properties
1 required
SessionSystemNotificationKind
string
EventTypeListResponseSchema
object
2 properties
2 required
NoteUpdatedV1ArtifactPayload
object
23 properties
13 required
CreateCollectionToolCallArgs
object
2 properties
1 required
DeleteCollectionToolCallResult
object
2 properties
1 required
MoveNoteToolCallResult
object
2 properties
1 required
FollowUpListResponseSchema
object
4 properties
3 required
WebClipSessionPart
object
8 properties
2 required
ApiRequestRecordCreatedNotificationPayload
object
1 property
1 required
NoteListItemResponseSchema
object
8 properties
6 required
AttachmentPdfResponseSchema
object
9 properties
SearchNotesToolCallArgs
object
4 properties
SessionStatus
string
CreateNoteResponseSchema
object
8 properties
8 required
SessionEventSystemNotificationV1Value
object
V1 version of system notification events. Represents a notification or message from the system.
3 properties
3 required
ArtifactSessionPartV1
object
6 properties
3 required
SearchNotesResultSchema
object
6 properties
4 required
RestoreNoteResponseSchema
object
1 property
1 required
SessionEventAgentOutputValue
object
Represents the thoughts associated with an agent at that point in time. (Often thoughts are associated with a specific tool call, but sometimes the agent just…
1 property
1 required
TrashNoteResponseSchema
object
1 property
1 required
CollectionSessionMention
object
Value class for collection mentions in sessions. Contains metadata specific to collection mentions.
3 properties
1 required
CollectionSearchRequestSchema
object
5 properties
ConnectionItemSchema
object
4 properties
2 required
ReadNoteToolCallResult
object
3 properties
1 required
UpdateCollectionDescriptionToolCallArgs
object
2 properties
2 required
ReasoningSessionPart
object
3 properties
1 required
UsageQuotaExceededBody
object
4 properties
3 required
CreateNoteToolCallArgs
object
2 properties
1 required
InterruptedToolCallResult
object
2 properties
AttachmentType
string
ReadCollectionToolCallResult
object
9 properties
1 required
SessionEventExternalInputValue
object
Represents an external input attached to the session.
2 properties
2 required
SessionEventUntypedEventDataSchema
object
For now, every other session event kind is bucketed as "untyped". (This mainly applies to our "legacy" event kinds.)
2 properties
2 required
SessionEventSystemNotificationV1EventDataSchema
object
2 properties
2 required
FileSessionPart
object
6 properties
4 required
SessionEventAgentToolInvocationValue
object
Roughly maps to Pydantic's ToolCallPart and ToolReturnPart. https://ai.dev/api/messages Represents an action taken by the agent. Note that multiple actions can…
7 properties
7 required
ViewNoteResponseSchema
object
6 properties
5 required
CollectionListItemResponseSchema
object
6 properties
6 required
ReadAudioRecordingResponseSchema
object
7 properties
4 required
SessionEventResponseSchema
object
10 properties
6 required
RemoveNoteFromCollectionToolCallResult
object
2 properties
1 required
SessionEventAgentDigestV1EventDataSchema
object
2 properties
2 required
UpsertSessionRequestSchema
object
5 properties
UsageQuotaUpgradeInfo
object
2 properties
2 required
McpInitializeRequestSchema
object
2 properties
2 required
SessionEventUserMessageValue
object
Represents messages sent by the user to the session.
1 property
1 required
GetHelpCenterInfoToolCallResult
object
3 properties
1 required
ExtendedSearchNoteResponseSchema
object
7 properties
2 required
ReadProjectResponseSchema
object
8 properties
8 required
GetHelpCenterInfoToolCallArgs
object
1 property
1 required
RestoreNoteToolCallResult
object
2 properties
1 required
SessionConfigResponseSchema
object
3 properties
1 required
EventListResponseSchema
object
5 properties
5 required
UpdateCalendarSettingsResponseSchema
object
2 properties
2 required
MemItApiRequestExternalInputPayload
object
2 properties
1 required
RetrieveDocumentPagesToolCallResult
object
4 properties
1 required
SessionEventExternalInputEventDataSchema
object
2 properties
2 required
SearchNotesToolCallResult
object
7 properties
1 required
FetchChatGPTItemResponseSchema
object
4 properties
2 required
DocumentPageContent
object
Full content for a single page returned by retrievedocumentpages.
4 properties
2 required
SessionEventAgentCommonActionV1Value
object
Agent action event for BaseAiAgent-backed common tools. Unlike SessionEventAgentActionV1Value, this stores the common tool name and raw JSON args/results direc…
11 properties
5 required
RenameCollectionToolCallArgs
object
2 properties
2 required
AgentCommonToolCallStatus
string
ProjectStatusInput
string
MoveNoteResponseSchema
object
1 property
1 required
DisconnectCalendarRequestSchema
object
1 property
1 required
UpdateCollectionDescriptionToolCallResult
object
2 properties
1 required
CreateFactCardToolCallResult
object
5 properties
1 required
ConnectCalendarResponseSchema
object
4 properties
4 required
AudioRecordingAttachmentResponseSchema
object
9 properties
SessionEventAgentOutputEventDataSchema
object
2 properties
2 required
SessionEventUserActionV1EventDataSchema
object
2 properties
2 required
EmailAttachmentResponseSchema
object
16 properties
6 required
UpdateNoteToolCallResult
object
3 properties
1 required
ReadNoteToolCallArgs
object
2 properties
1 required
NoteAttachmentMetadataResponseSchema
object
8 properties
2 required
SessionMentionKind
string
Enum for different types of session mentions.
SearchForCollectionsToolCallResult
object
3 properties
1 required
ReadCollectionToolCallArgs
object
3 properties
1 required
SearchChatGPTRequestSchema
object
4 properties
1 required
WebClipCreatedNotificationPayload
object
1 property
1 required
ImageSessionPart
object
5 properties
3 required
CreateDraftNoteToolCallResult
object
3 properties
1 required
AgentAttachmentMetadata
object
Compact attachment metadata included implicitly when the agent reads a note.
8 properties
2 required
SessionEventUserActionV1Value
object
V1 version of user message events. Represents messages sent by the user to the session.
2 properties
1 required
SearchWithinDocumentToolCallArgs
object
2 properties
2 required
ListCalendarsResponseSchema
object
2 properties
2 required
RelatedNoteCollectionResponseSchema
object
7 properties
6 required
EventPrimaryEntityResponseSchema
object
2 properties
2 required
SessionConfigSchema
object
3 properties
1 required
RetrieveDocumentPagesToolCallArgs
object
2 properties
2 required
FetchChatGPTRequestSchema
object
1 property
1 required
UpdateCollectionRequestSchema
object
3 properties
FindRelatedNotesToolCallArgsLegacy
object
2 properties
2 required
InterruptV1SessionPart
object
4 properties
2 required
TaskListResponseSchema
object
4 properties
3 required
ReconcileCalendarResponseSchema
object
2 properties
2 required
ConnectCalendarRequestSchema
object
2 properties
1 required
ChipSessionPart
object
3 properties
1 required
AddNoteToCollectionToolCallResult
object
2 properties
1 required
AnswerQuestionAboutAttachmentRequestSchema
object
3 properties
3 required
SessionEventAgentPlanningV1EventDataSchema
object
2 properties
2 required
MarkdownV1SessionPart
object
5 properties
2 required
MoveNoteToolCallArgs
object
3 properties
3 required
AttachmentReference
object
Sidecar metadata for markdown links that point at a specific attachment page.
3 properties
3 required
SessionResponseSchema
object
9 properties
5 required
SearchSessionEventsResponseSchema
object
2 properties
2 required
CollectionSearchResponseSchema
object
3 properties
3 required
SessionArtifactPartKind
string
NoteListResponseSchema
object
4 properties
3 required
SearchWithinDocumentToolCallResult
object
4 properties
1 required
GetUserAccountStatisticsToolCallResult
object
9 properties
1 required
UserActionV1SessionEventContext
object
Context for V1 user action session events. Contains additional metadata about the user action.
3 properties
CreateDraftNoteToolCallArgs
object
1 property
1 required
SessionEventAgentToolInvocationEventDataSchema
object
2 properties
2 required
MoveNoteRequestSchema
object
1 property
1 required
FetchChatGPTItemRequestSchema
object
2 properties
2 required
SearchChatGPTResultSchema
object
7 properties
3 required
FindRelatedNotesToolCallResult
object
3 properties
1 required
ExtendedSearchNotesRequestSchema
object
8 properties
1 required
UpdateCollectionResponseSchema
object
6 properties
6 required
UpdateNoteResponseSchema
object
9 properties
9 required
UsageQuotaExceededPayload
object
Stable public payload shared by quota producers and HTTP consumers.
1 property
1 required
CollectionSearchItemResponseSchema
object
6 properties
6 required
MemItResponseSchema
object
1 property
1 required
SearchChatGPTResponseSchema
object
4 properties
4 required
CalendarEventItemSchema
object
10 properties
1 required
WebClipV1SessionPart
object
15 properties
3 required
AgentToolCallKind
string
Enum for different types of agent tool calls with version information.
SessionEventAgentPlanningV1Value
object
V1 version of agent output events. Represents the thoughts/outputs associated with an agent at that point in time.
2 properties
1 required
CreateCollectionToolCallResult
object
3 properties
1 required
MessageSessionPart
object
3 properties
1 required
UpdateNoteToolCallArgs
object
4 properties
3 required
CreateCollectionResponseSchema
object
6 properties
6 required
NoteSearchItemResponseSchema
object
8 properties
6 required
WebsiteLinkChipSessionPartPayload
object
3 properties
2 required
TrashNoteToolCallResult
object
2 properties
1 required
FindRelatedNotesToolCallArgs
object
1 property
1 required
ReadTaskResponseSchema
object
9 properties
9 required
RemoveNoteFromCollectionResponseSchema
object
1 property
1 required
NoteSessionMention
object
Value class for note mentions in sessions. Contains metadata specific to note mentions.
3 properties
1 required
GetUserAccountStatisticsToolCallArgs
object
Empty args model since this tool doesn't require any parameters.
ReasoningV1SessionPart
object
8 properties
2 required
SessionEventAgentDigestV1Value
object
V1 version of agent digest events.
1 property
1 required
FollowUpResponseItemSchema
object
17 properties
17 required
DisconnectCalendarResponseSchema
object
2 properties
2 required
SearchNotesRequestSchema
object
3 properties
1 required
SearchNotesByTimeRangeSessionMention
object
Value class for search notes by time range mentions in sessions. Contains metadata specific to search notes by time range mentions.
3 properties
ExternalEventType
string
NoteChipSessionPartPayload
object
3 properties
2 required
RestoreNoteToolCallArgs
object
1 property
1 required
SessionEventAgentActionV1Value
object
V1 version of agent tool invocation events. Represents an action taken by the agent.
8 properties
7 required
FetchChatGPTItemPayloadSchema
object
5 properties
1 required
AttachmentImageResponseSchema
object
8 properties
SearchNotesAiToolSortBy
string
ReadAttachmentResponseSchema
object
8 properties
3 required
ProjectListResponseSchema
object
4 properties
3 required
MessageUserToolCallResult
object
2 properties
1 required
NoteSearchRequestSchema
object
11 properties
1 required
RemoveNoteFromCollectionToolCallArgs
object
2 properties
2 required
CreateNoteRequestSchema
object
6 properties
1 required
ViewImageToolCallResult
object
4 properties
1 required
NoteSearchResponseSchema
object
7 properties
7 required
CalendarEventAttachmentResponseSchema
object
16 properties
4 required
UpdateNoteRequestSchema
object
3 properties
2 required
DraftNoteV1SessionPart
object
4 properties
2 required
EventResponseSchema
object
7 properties
7 required
NoteCreatedV1ArtifactPayload
object
17 properties
7 required
FollowUpStatusInput
string
DeleteNoteResponseSchema
object
1 property
1 required
SetNoteCreatedAtRequestSchema
object
1 property
1 required
ReadFollowUpResponseSchema
object
2 properties
2 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Mem 4
Other APIs Mem publishes across the network.
Mem CoreApi__service-info API
Mem external API
Mem external-v0 API
Mem external-v1 API
#external-v2
Where this information came from
This is an independent, third-party profile of Mem external-v2 API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.