Archive a character

POST

/v1/characters/:slug/archive

POST

/v1/characters/:slug/archive

curl -X POST https://api.loreos.app/v1/characters/slug/archive \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "schema_version": "string",
  "data": {
    "character_id": "string",
    "slug": "string",
    "canonical_slug": "string",
    "requested_slug": "string",
    "lifecycle_state": "string",
    "status": "string",
    "changed": true,
    "cancelled_background_jobs": 1,
    "background_features": {
      "deactivated": [
        {
          "feature": "string",
          "schedule_id": "string"
        }
      ],
      "already_off": [
        {
          "feature": "string",
          "schedule_id": "string"
        }
      ],
      "failed": [
        {
          "feature": "string",
          "schedule_id": "string",
          "error": "string"
        }
      ]
    }
  },
  "next_actions": [
    {
      "command": "string",
      "description": "string"
    }
  ]
}

Reversibly deactivate a character across inventory and runtime.

Archive is app-wide lifecycle state, not an end-user block. New sessions and existing session messages stop before budget/provider calls; background feature schedules are deactivated best-effort.

Authentication

AuthorizationBearer

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

Path parameters

slugstringRequired

Request

This endpoint expects a nullable object.

reasonstring or nullOptional<=500 characters

Optional developer-visible lifecycle reason for audit/history.

Response

Successful Response

schema_version"v0"

LoreOS success-envelope version.

dataobject

next_actionslist of objects

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

Errors

404

Not Found Error

409

Conflict Error

410

Gone Error

422

Unprocessable Entity Error