Dismiss an action

.md

Put away an action card under an answer without doing it.

Scopesai:write
POST/v1/me/ai/actions/{id}/dismiss

Puts an action card away. Nothing happens to the records it named, and it can no longer be confirmed. The assistant reads on the next question that it was dismissed.

Only a card that is still proposed is dismissed. One that was already done, failed, expired or dismissed is answered as it stands, unchanged, so a press that crossed a confirm on another device never undoes it. Every device that has the conversation open hears action_updated on its channel.

Request

curl -X POST https://api.proppertrading.com/v1/me/ai/actions/aiact_5yvyy7ta3whmen7m/dismiss \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f" \
  -H "Idempotency-Key: 7e2b9d41-3c8a-4f16-b5d0-2a6c8e4f9b13"

Response

{
    "data": {
        "id": "aiact_5yvyy7ta3whmen7m",
        "object": "ai_action",
        "kind": "AssignTicket",
        "title": "Assign ticket #H3HK28 to Hannah Weber",
        "lines": [
            "#H3HK28 Spike breached my account",
            "Held by Olivia Bennett now"
        ],
        "records": [
            {
                "label": "#H3HK28 Spike breached my account",
                "url": "/admin/tickets/tkt_nfpbhxqrmph3hk28"
            }
        ],
        "destructive": false,
        "ask": null,
        "status": "dismissed",
        "outcome": null,
        "expires_at": "2026-10-23T02:52:49+00:00",
        "decided_at": "2026-10-22T02:52:53+00:00"
    },
    "meta": {
        "request_id": "req_01m5grd5w7s6f0b2asr0d3ekxc"
    }
}

Errors

StatusCodeMeaning
400missing_idempotency_keyEvery POST needs one
400workspace_requiredOur own staff, without a firm in Propper-Workspace
403ai_unavailableThe firm has the assistant switched off for this chat
403forbiddenStaff whose role does not include use_ai_chat
403insufficient_scopeThis device does not hold ai:write
404resource_not_foundNo card with that id was proposed to you, in this chat and this firm