API Reference
/
v1
/
Update User Schema V1

Papr Memory API (1.0.0)

API for managing memory, context, and retrieval for AI agents or apps with authentication and user-specific data.

Authentication

This API supports three authentication methods:

  • API Key: Include your API key in the X-API-Key header
    X-API-Key: <your-api-key>
  • Session Token: Include your session token in the X-Session-Token header
    X-Session-Token: <your-session-token>
  • Bearer Token: Include your OAuth2 token from Auth0 in the Authorization header
    Authorization: Bearer <token>

All endpoints require one of these authentication methods.

Download OpenAPI description
index.json
index.yaml
Languages
Servers
Production server
http://memory.papr.ai/

v1

Operations

Get User Schema V1

Request

Get a specific schema by ID.

Returns the complete schema definition including node types, relationship types, and metadata. User must have read access to the schema.

Path
schema_idstring(Schema Id)required
curl -i -X GET \
  'http://memory.papr.ai/v1/schemas/{schema_id}' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Schema retrieved successfully

Bodyapplication/json
successboolean(Success)required
dataUserGraphSchema (object) or null
Any of:

Complete user-defined graph schema

errorError (string) or Error (null)(Error)
Any of:
string(Error)
codeinteger(Code)
Default 200
Response
application/json
{
  "success": true,
  "data": {
    "id": "string",
    "name": "string",
    "description": "string",
    "version": "1.0.0",
    "user_id": "string",
    "workspace_id": "string",
    "organization_id": "string",
    "node_types": { … },
    "relationship_types": { … },
    "status": "draft",
    "scope": "personal",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "read_access": [ … ],
    "write_access": [ … ],
    "usage_count": 0,
    "last_used_at": "2019-08-24T14:15:22Z"
  },
  "error": "string",
  "code": 200
}

Update User Schema V1

Request

Update an existing schema.

Allows modification of schema properties, node types, and relationship types. User must have write access to the schema. Updates create a new version while preserving the existing data.

Path
schema_idstring(Schema Id)required
Bodyapplication/jsonrequired
property name*anyadditional property
curl -i -X PUT \
  'http://memory.papr.ai/v1/schemas/{schema_id}' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{}'

Responses

Schema updated successfully

Bodyapplication/json
successboolean(Success)required
dataUserGraphSchema (object) or null
Any of:

Complete user-defined graph schema

errorError (string) or Error (null)(Error)
Any of:
string(Error)
codeinteger(Code)
Default 200
Response
application/json
{
  "success": true,
  "data": {
    "id": "string",
    "name": "string",
    "description": "string",
    "version": "1.0.0",
    "user_id": "string",
    "workspace_id": "string",
    "organization_id": "string",
    "node_types": { … },
    "relationship_types": { … },
    "status": "draft",
    "scope": "personal",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "read_access": [ … ],
    "write_access": [ … ],
    "usage_count": 0,
    "last_used_at": "2019-08-24T14:15:22Z"
  },
  "error": "string",
  "code": 200
}

Delete User Schema V1

Request

Delete a schema.

Soft deletes the schema by marking it as archived. The schema data and associated graph nodes/relationships are preserved for data integrity. User must have write access to the schema.

Path
schema_idstring(Schema Id)required
curl -i -X DELETE \
  'http://memory.papr.ai/v1/schemas/{schema_id}' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Schema deleted successfully

Bodyapplication/json
any
Response
application/json
null

Memory

Operations

User

Operations

Feedback

Operations

Document

Operations

Schema Management

Operations

GraphQL

Operations