> ## Documentation Index > Fetch the complete documentation index at: https://docs.seynlabs.com/llms.txt > Use this file to discover all available pages before exploring further. # Get memory status > Poll a memory you submitted to /v1/knowledge/memory. Processing moves `queued` → `processing` → `applied` (or `error`). Poll this endpoint with the `memoryId` returned by [Add a memory](/api-reference/add-memory). Once `applied`, the `summary` field explains in plain language what Seyn understood and did, and the counts report how many assertions it created or superseded. If a memory contradicted an existing rule, you'll see it reflected as a supersession rather than a duplicate. ## OpenAPI ````yaml openapi.yaml GET /v1/knowledge/memory/{memoryId} openapi: 3.1.0 info: title: Seyn API version: 1.0.0 description: > Programmatic access to Seyn for your organization. - **Ingest** data from any source with the Ingestion endpoints (requires a key with the `ingest` scope). - **Read** extracted process knowledge: search, rules, libraries, provenance, and metrics. Authenticate with a bearer API key (`sk_live_*`); each key is scoped to a single organization. contact: name: Seyn Support email: support@seynlabs.com url: https://seynlabs.com servers: - url: https://api.seynlabs.com description: Production - url: https://api-dev.seynlabs.com description: Staging security: - bearerAuth: [] tags: - name: Ingestion description: >- Push data into Seyn from any source: register a custom source and stream records to it - name: Knowledge description: Natural-language search over extracted knowledge - name: Rules description: Process rules, the atomic knowledge units extracted by the pipeline - name: Libraries description: Versioned snapshots of extracted knowledge for your organization - name: Patterns description: Aggregate pipeline analytics paths: /v1/knowledge/memory/{memoryId}: get: tags: - Knowledge summary: Get memory status description: > Poll a submitted memory. Processing moves `queued` → `processing` → `applied` (or `error`). Once applied, `summary` explains what Seyn understood and the counts report how many assertions it created or superseded. operationId: knowledgeMemoryGet parameters: - name: memoryId in: path required: true schema: type: string format: uuid responses: '200': description: Memory status. content: application/json: schema: $ref: '#/components/schemas/SuccessEnvelope_MemorySubmission' example: success: true data: memoryId: c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f status: applied text: >- Deals over $50M always need board sign-off, not just the CEO. This has been true since Q1. summary: >- Recorded a policy on the deal pipeline: deals above $50M require board approval. Superseded the prior CEO-only approval rule. assertionsCreated: 1 assertionsSuperseded: 1 createdAt: '2026-06-12T16:30:00Z' meta: requestId: 9d0e1f2a-3b4c-4d5e-8f6a-7b8c9d0e1f2a '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' components: schemas: SuccessEnvelope_MemorySubmission: type: object properties: success: type: boolean enum: - true data: $ref: '#/components/schemas/MemorySubmission' meta: $ref: '#/components/schemas/Meta' required: - success - data - meta MemorySubmission: type: object properties: memoryId: type: string format: uuid status: type: string enum: - queued - processing - applied - error description: Processing runs asynchronously after the memory is accepted. text: type: string description: The submitted text, echoed back. summary: type: - string - 'null' description: >- Plain-language account of what Seyn understood and did. Populated once status is `applied`. assertionsCreated: type: integer minimum: 0 description: Assertions written. Populated once status is `applied`. assertionsSuperseded: type: integer minimum: 0 description: >- Existing assertions superseded by this memory. Populated once status is `applied`. createdAt: type: string format: date-time required: - memoryId - status - text - createdAt Meta: type: object properties: requestId: type: string description: Per-request UUID; quote in support tickets. additionalProperties: true required: - requestId ErrorBody: type: object properties: success: type: boolean enum: - false error: type: object properties: code: type: string enum: - MISSING_AUTH_HEADER - INVALID_API_KEY - KEY_REVOKED - RATE_LIMITED - NOT_FOUND - LIBRARY_NOT_FOUND - SOURCE_NOT_FOUND - VALIDATION_ERROR - INSUFFICIENT_SCOPE - PAYLOAD_TOO_LARGE - INTERNAL_ERROR message: type: string required: - code - message required: - success - error responses: Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' examples: missing: summary: No Authorization header value: success: false error: code: MISSING_AUTH_HEADER message: 'Authorization: Bearer header is required' invalid: summary: Unrecognized key value: success: false error: code: INVALID_API_KEY message: API key is invalid or unrecognized Forbidden: description: API key was revoked. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' examples: revoked: value: success: false error: code: KEY_REVOKED message: API key has been revoked NotFound: description: Resource not found in this organization. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' examples: notFound: value: success: false error: code: NOT_FOUND message: Process rule not found RateLimited: description: Per-key rate limit exceeded (default 60 req/min/key). content: application/json: schema: $ref: '#/components/schemas/ErrorBody' examples: rateLimited: value: success: false error: code: RATE_LIMITED message: Rate limit exceeded for this API key securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: sk_live_* description: | Bearer token from `app.seynlabs.com` → Settings → API Keys. Send as `Authorization: Bearer sk_live_...`. ````