Delete a character

DELETE

/v1/characters/:slug

DELETE

/v1/characters/:slug

curl -X DELETE "https://api.loreos.app/v1/characters/slug?confirm_slug=confirm_slug" \
     -H "Authorization: Bearer <token>"

{
  "schema_version": "string",
  "data": {
    "character_id": "string",
    "slug": "string",
    "canonical_slug": "string",
    "requested_slug": "string",
    "lifecycle_state": "string",
    "status": "string",
    "request_status": "requested",
    "purge_summary": {},
    "background_features": {
      "deactivated": [
        {
          "feature": "string",
          "schedule_id": "string"
        }
      ],
      "already_off": [
        {
          "feature": "string",
          "schedule_id": "string"
        }
      ],
      "failed": [
        {
          "feature": "string",
          "schedule_id": "string",
          "error": "string"
        }
      ]
    },
    "deletion_request_id": "string",
    "error_message": "string",
    "requested_at": "2024-01-15T09:30:00Z",
    "started_at": "2024-01-15T09:30:00Z",
    "completed_at": "2024-01-15T09:30:00Z"
  },
  "next_actions": [
    {
      "command": "string",
      "description": "string"
    }
  ]
}

Irreversibly delete one app-owned character.

The canonical row becomes a tombstone and the slug remains reserved. Authored versions, locale versions, visual inventory, session rows, and background ledgers are purged/redacted by an async deletion request.

Authentication

AuthorizationBearer

LoreOS runtime API key (ck_...), sent as Authorization: Bearer <key>.

Path parameters

slugstringRequired

Query parameters

confirm_slugstringRequired>=1 character

Required exact canonical slug confirmation for irreversible delete.

forcebooleanOptionalDefaults to false

When false, the character must be archived before deletion.

reasonstring or nullOptional<=500 characters

Optional developer-visible deletion reason for audit/history.

Response

Successful Response

schema_version"v0"

LoreOS success-envelope version.

dataobject

Accepted permanent-delete request (HTTP 202).

status is always deleted because the canonical row is tombstoned synchronously; request_status carries the asynchronous purge state. The timestamp and error fields are absent when the character was already purged.

next_actionslist of objects

Concrete follow-up API actions; empty when no action is required.

Errors

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error