Memories

Search memories

Changed on

List active memories in a scope by lexicographic key prefix. Results are ordered by key ascending. The meta.cursor value is the next key cursor; pass it back as cursor to continue after that key.

Search records one memory read usage event for the operation. Pass include_value=false to return metadata only.

get/memories/search

Request

  • Base URL: https://api.primitive.dev/v1
  • URL: https://api.primitive.dev/v1/memories/search
  • Auth: HTTP bearer

Query parameters

prefixstring

Key prefix to match. Empty string lists all active memories in the selected scope. Must be at most 512 UTF-8 bytes.

cursorstring

Key cursor from a previous response's meta.cursor. The next page starts after this key.

limitinteger

Number of results per page

include_value'true' | 'false'

Pass false to omit the value field and return metadata only.

updated_afterstring date-time

Only include memories updated at or after this timestamp.

updated_beforestring date-time

Only include memories updated at or before this timestamp.

scope_type'org' | 'function'

Explicit scope type. Omit to use automatic scope resolution. Pass function with scope_id=<function-id>, or org with no scope_id.

scope_idstring uuid

Function id UUID when scope_type=function. Not valid with scope_type=org.

Headers

x-primitive-function-idstring uuid

Optional function id UUID used as the default scope when query scope parameters are omitted.

Response

Paginated memory records

successboolean required

Changes

  • 52138fa51360Revision changes
    • info

      removed the invalid_signup_code enum value from the / response property for the response status

    • info

      removed the invalid_signup_code enum value from the / response property for the response status

    • info

      removed the invalid_signup_code enum value from the / response property for the response status

    • info

      removed the invalid_signup_code enum value from the / response property for the response status

    • info

      removed the invalid_signup_code enum value from the / response property for the response status

  • 22d1dfc68434Revision changes
    • warning

      added the new not_a_repeating_send enum value to the / response property for the response status

    • warning

      added the new not_a_repeating_send enum value to the / response property for the response status

    • warning

      added the new not_a_repeating_send enum value to the / response property for the response status

    • warning

      added the new not_a_repeating_send enum value to the / response property for the response status

    • warning

      added the new not_a_repeating_send enum value to the / response property for the response status

    • warning

      added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status

    • warning

      added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status

    • warning

      added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status

    • warning

      added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status

    • warning

      added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status

    • warning

      added the new repeat_recipient_external enum value to the / response property for the response status

    • warning

      added the new repeat_recipient_external enum value to the / response property for the response status

    • warning

      added the new repeat_recipient_external enum value to the / response property for the response status

    • warning

      added the new repeat_recipient_external enum value to the / response property for the response status

    • warning

      added the new repeat_recipient_external enum value to the / response property for the response status

    • warning

      added the new repeat_stop_not_allowed enum value to the / response property for the response status

    • warning

      added the new repeat_stop_not_allowed enum value to the / response property for the response status

    • warning

      added the new repeat_stop_not_allowed enum value to the / response property for the response status

    • warning

      added the new repeat_stop_not_allowed enum value to the / response property for the response status

    • warning

      added the new repeat_stop_not_allowed enum value to the / response property for the response status

    • warning

      added the new repeat_unsupported enum value to the / response property for the response status

    • warning

      added the new repeat_unsupported enum value to the / response property for the response status

    • warning

      added the new repeat_unsupported enum value to the / response property for the response status

    • warning

      added the new repeat_unsupported enum value to the / response property for the response status

    • warning

      added the new repeat_unsupported enum value to the / response property for the response status