Skip to content

Project API Fresh

Manage projects within organizations to isolate memory resources.

Base URL: https://api.mem0.ai

Authentication: Authorization: Token <MEM0_API_KEY>


Create Project

POST /api/v1/orgs/organizations/{org_id}/projects/

Path Parameters

ParameterTypeRequiredDescription
org_idstringYesOrganization identifier.

Request Body

FieldTypeRequiredDescription
namestringYesName of the project.

Response (200)

json
{
  "message": "Project created successfully.",
  "project_id": "uuid"
}

Errors

  • 400: "Project could not be created."
  • 403: "Unauthorized to create projects in this organization."

Get Projects (List)

GET /api/v1/orgs/organizations/{org_id}/projects/

Response (200)

json
[
  {
    "id": 1,
    "project_id": "uuid",
    "name": "My Project",
    "description": "",
    "created_at": "2024-07-15T10:30:00Z",
    "updated_at": "2024-07-15T10:30:00Z",
    "members": [
      { "username": "admin", "role": "OWNER" }
    ]
  }
]

Get Project (Single)

GET /api/v1/orgs/organizations/{org_id}/projects/{project_id}/

Path Parameters

ParameterTypeRequired
org_idstringYes
project_idstringYes

Response (200)

Same schema as list response, single object.

Error (404)

json
{ "message": "Organization or project not found" }

Get Project Members

GET /api/v1/orgs/organizations/{org_id}/projects/{project_id}/members/

Response (200)

json
{
  "members": [
    { "username": "admin", "role": "OWNER" },
    { "username": "dev1", "role": "READER" }
  ]
}

Add Project Member

POST /api/v1/orgs/organizations/{org_id}/projects/{project_id}/members/

Request Body

FieldTypeRequiredDescription
emailstringYesEmail of the member.
rolestringYesREADER or OWNER.

Response (200)

json
{ "message": "User added to the project successfully" }

Delete Project

DELETE /api/v1/orgs/organizations/{org_id}/projects/{project_id}/

Response (200)

json
{ "message": "Project and related data deleted successfully" }

Errors

  • 403: "Unauthorized to modify this project"
  • 404: "Organization or project not found"

SOP Documentation Site for Mem0