---
title: "List the memories and persona entries uploaded to an AI consciousness."
method: POST
path: "/v1/get_texts"
tags: ["Memories"]
---

# List the memories and persona entries uploaded to an AI consciousness.

`POST /v1/get_texts`

## Request

- Base URL: `https://partner.mindupload.app`
- URL: `https://partner.mindupload.app/v1/get_texts`
- Auth: API key in header `X-Partner-Key`

## Request body

- object
  - `preferred_language` string, nullable: BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages.
  - `page` integer, nullable
  - `page_size` integer: Maximum records requested for one server-capped page.
  - `sort_by` string, nullable
  - `sort_order` integer, nullable: Sort direction; supported values depend on the operation.
  - `use_cursor_pagination` boolean, nullable
  - `cursor_value` string, nullable: Opaque pagination cursor value from the previous page (`next_cursor_value`).
  - `cursor_id` string, nullable: Opaque pagination cursor id from the previous page (`next_cursor_id`).
  - `username` string, nullable: The end-user's username.
  - `password` string, nullable: The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage.
  - `codename` string, nullable: Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone.
  - `type` 'memory' | 'persona' | 'conscious', nullable

## Response `200`

Result envelope — check the success field.

- object
  - `success` boolean: Whether the call succeeded.
  - `error_message` string, nullable: Human-readable reason when success is false.
  - `error_code` string
  - `total_count` integer, nullable
  - `page` integer, nullable
  - `page_size` integer, nullable: Maximum records requested for one server-capped page.
  - `total_pages` integer, nullable
  - `has_next` boolean, nullable: True when another page is available after this response.
  - `has_prev` boolean, nullable
  - `next_cursor_value` string, nullable: Pass as `cursor_value` on the next page request.
  - `next_cursor_id` string, nullable: Pass as `cursor_id` on the next page request.
  - `texts` object[], nullable
    - `_id` string, required
    - `clone_id` string, required: AI consciousness id as returned by clone operations.
    - `user_id` string, required
    - `multimedia_ids` string[], nullable
    - `text` string, nullable, required
    - `type` string, nullable, required
    - `created_at` integer, nullable, required
    - `updated_at` integer, nullable, required: Opaque freshness watermark to send back as `known_updated_at` on the next poll.
    - `is_active` boolean, nullable, required
    - `pending_owner_review` boolean, nullable, required
    - `source_label` string, nullable, required
    - `reconcile_flagged_at` integer, nullable, required
    - `owner_reviewed_at` integer, nullable, required
    - `media` object[]
      - `media_id` string, required
      - `media_type` string, required: The kind of media: `image`, `video`, or `audio`.
      - `media_url` string, required: Media URL returned by this operation; use signed read URLs unchanged.
      - `content_type` string, required
      - `file_size_bytes` integer, required
      - `expires_at` integer, required: UNIX timestamp when this resource or capability expires.
    - `reading_provenance` object
      - `content_state` 'checked_candidate' | 'owner_edited', required
      - `memory_kinds` string[], required
      - `sources` object[], required
        - `source_kind` 'page' | 'media', required
        - `title` string
        - `url` string: Where the attachment is — the `media_url` an upload returned, or an external link. Echoed back in the result so you can match each entry to what you sent.
        - `media_id` string
        - `source_id` string, required

## Other responses

- `400`: Invalid request payload.
- `401`: Missing or invalid partner key.
- `403`: Partner is not authorized for this operation.
- `429`: Rate limit exceeded — retry later.
- `500`: Internal server error.

---

[API](https://skmtc.dev/mindupload/apis/mind-upload-partner-api.md) · [All operations](https://skmtc.dev/mindupload/apis/mind-upload-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mindupload/apis/mind-upload-partner-api/revisions/0371bdf78533?raw)