Update interaction status when the member acts on a card

Lifecycle transitions: `pending → opened → completed | dismissed`, or the direct `pending → dismissed`. Same-status PATCHes are accepted as no-ops. Other transitions return `422`. Returns `204 No Content` on success.

Authorization

MemberBearer

AuthorizationBearer <token>

Member-scoped JWT minted by POST /v1/auth/token. Required on every /v1/users/{user_id}/... route; the token's sub claim must match the path user_id.

In: header

Path Parameters

user_id*User Id

Formatuuid

card_item_id*Card Item Id

Formatuuid

Header Parameters

org-id?string|null

x-user-id?string|null

x-request-id?string|null

traceparent?string|null

Idempotency-Key?|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

interaction_status*Interaction Status

Value in"pending" | "opened" | "completed" | "dismissed"

Response Body

`application/json`

curl -X PATCH "https://loading/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/cards/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "interaction_status": "pending"  }'

Empty

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}