IonWarp logoIonWarp
Get started
IonWarp Docs
Collections

Preferences

Per-project dashboard state (notification read/cleared markers).

Base path /api/v1/preferences on https://ionwarp.com. Authenticate with Authorization: Bearer $DASH_API_KEY and name the project with the Project-ID header. Writes are validated in open mode; an operation this resource does not declare answers 405 operation_not_supported.

Retrieve a preference

GET /api/v1/preferences/learning-tests-run-under-bun

curl "https://ionwarp.com/api/v1/preferences/learning-tests-run-under-bun" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_acme"
Open the preference {id}
data_get {
  "collection": "_preferences",
  "object_id": "learning-tests-run-under-bun"
}

Returns the preference object.

{
  "object": "preference",
  "id": "obj_123",
  "created_at": "2026-07-25T12:00:00.000Z",
  "updated_at": "2026-07-25T12:00:00.000Z"
}

Parameters

ParameterTypeKindDescription
idstringpathThe preference's id or slug.

What comes back (read-only)

Every preference carries the envelope below. This resource declares no server-owned fields beyond it.

FieldTypeDescription
objectstringAlways preference.
idstringStable object id. Also accepted in place of slug on any path.
slugstringURL-safe name, unique within the collection.
created_atstringISO-8601 timestamp of the first write.
updated_atstringISO-8601 timestamp of the most recent write. The cursor sorts on this.

Errors

Failures use { error: { type, code, message, param } }. The full code table is generated at Error Codes.

On this page

IonWarp logoIonWarp

Ready to build? Connect an agent and go — no credit card needed to start.

Get startedSee our plans