GoodMem
ReferenceAPIREST APIMemories

Create multiple memories in a batch

Creates multiple memories in a single operation, with individual success/failure results.

POST
/v1/memories:batchCreate
x-api-key<token>

In: header

Batch memory creation details. For application/json requests, each item must provide exactly one of originalContent or originalContentB64. For multipart/form-data, provide a requests part and one file part per request.

requestsarray<JsonMemoryCreationRequest>

Array of memory creation requests.

Items1 <= items

Response Body

curl -X POST "http://localhost:8080/v1/memories:batchCreate" \  -H "Content-Type: application/json" \  -d '{    "requests": [      {        "memoryId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",        "spaceId": "550e8400-e29b-41d4-a716-446655440000",        "originalContent": "This is the text content to be stored as a memory.",        "originalContentB64": "VGhpcyBpcyBiYXNlNjQgZW5jb2RlZCBjb250ZW50",        "originalContentRef": "s3://my-bucket/document.pdf",        "contentType": "text/plain",        "metadata": {          "source": "document",          "author": "John Doe",          "tags": [            "important"          ]        },        "chunkingConfig": {          "recursive": {            "chunkSize": 1000,            "chunkOverlap": 200,            "separators": [              "\n\n",              "\n",              ".",              " "            ],            "separatorIsRegex": false          }        }      }    ]  }'
{
  "results": [
    {
      "success": true,
      "memoryId": "550e8400-e29b-41d4-a716-446655440000",
      "memory": {
        "memoryId": "550e8400-e29b-41d4-a716-446655440000",
        "spaceId": "550e8400-e29b-41d4-a716-446655440001",
        "originalContent": "VGhpcyBpcyBiYXNlNjQgYmluYXJ5Lg==",
        "originalContentSha256": "9f2c8c5a9d740eb56d...",
        "originalContentRef": "s3://my-bucket/document.pdf",
        "contentType": "text/plain",
        "processingStatus": "COMPLETED",
        "pageImageStatus": "COMPLETED",
        "pageImageCount": 12,
        "createdAt": 1672531200000,
        "updatedAt": 1672531200000,
        "createdById": "550e8400-e29b-41d4-a716-446655440002",
        "updatedById": "550e8400-e29b-41d4-a716-446655440002",
        "chunkingConfig": {
          "recursive": {
            "chunkSize": 1000,
            "chunkOverlap": 200,
            "separators": [
              "\n\n",
              "\n",
              ".",
              " "
            ],
            "keepStrategy": "KEEP_END",
            "separatorIsRegex": false,
            "lengthMeasurement": "CHARACTER_COUNT"
          },
          "sentence": {
            "maxChunkSize": 1000,
            "minChunkSize": 100,
            "enableLanguageDetection": true,
            "lengthMeasurement": "CHARACTER_COUNT"
          }
        },
        "processingHistory": {
          "latestJob": {
            "jobId": 42,
            "jobType": "document_processor",
            "status": "BACKGROUND_JOB_RUNNING",
            "attempts": 1,
            "maxAttempts": 5,
            "runAt": 1714713600000,
            "leaseUntil": 1714713660000,
            "lockedBy": "worker-1",
            "lastError": "Transient network failure",
            "updatedAt": 1714713615000
          }
        }
      },
      "error": {
        "code": 403,
        "message": "Forbidden - insufficient permissions"
      }
    }
  ]
}
{
  "results": [
    {
      "success": true,
      "memoryId": "550e8400-e29b-41d4-a716-446655440000",
      "memory": {
        "memoryId": "550e8400-e29b-41d4-a716-446655440000",
        "spaceId": "550e8400-e29b-41d4-a716-446655440001",
        "originalContent": "VGhpcyBpcyBiYXNlNjQgYmluYXJ5Lg==",
        "originalContentSha256": "9f2c8c5a9d740eb56d...",
        "originalContentRef": "s3://my-bucket/document.pdf",
        "contentType": "text/plain",
        "processingStatus": "COMPLETED",
        "pageImageStatus": "COMPLETED",
        "pageImageCount": 12,
        "createdAt": 1672531200000,
        "updatedAt": 1672531200000,
        "createdById": "550e8400-e29b-41d4-a716-446655440002",
        "updatedById": "550e8400-e29b-41d4-a716-446655440002",
        "chunkingConfig": {
          "recursive": {
            "chunkSize": 1000,
            "chunkOverlap": 200,
            "separators": [
              "\n\n",
              "\n",
              ".",
              " "
            ],
            "keepStrategy": "KEEP_END",
            "separatorIsRegex": false,
            "lengthMeasurement": "CHARACTER_COUNT"
          },
          "sentence": {
            "maxChunkSize": 1000,
            "minChunkSize": 100,
            "enableLanguageDetection": true,
            "lengthMeasurement": "CHARACTER_COUNT"
          }
        },
        "processingHistory": {
          "latestJob": {
            "jobId": 42,
            "jobType": "document_processor",
            "status": "BACKGROUND_JOB_RUNNING",
            "attempts": 1,
            "maxAttempts": 5,
            "runAt": 1714713600000,
            "leaseUntil": 1714713660000,
            "lockedBy": "worker-1",
            "lastError": "Transient network failure",
            "updatedAt": 1714713615000
          }
        }
      },
      "error": {
        "code": 403,
        "message": "Forbidden - insufficient permissions"
      }
    }
  ]
}
Empty
Empty
Empty