Cards

Tap a card's button

Dispatch is on the button's own server-recorded action_type, NEVER its label: pay creates a real TransferRequest against the owner's matching-currency wallet (refused for a guest session -- see 403); handoff runs the same authorized hand-off chats#hand_off uses; signup (guest chats) is never forwarded anywhere; anything else forwards to the card owner's webhook/socket outbox as a card_interaction event. values is an optional {block_id => answer} map answering the card's own input blocks -- every key must name an input block this card declares and every value must be a string no longer than that block's own max_length, else a 422 with one plain sentence. A pay, handoff or signup button ignores values entirely.

post/api/v1/cards/{id}/actions

Request

  • Base URL: https://saltapp.ai
  • URL: https://saltapp.ai/api/v1/cards/{id}/actions
  • Auth: API key in header api-key

Path parameters

idstring required

Request body

action_idstring required
valuestring
valuesobject

{block_id => answer}, for the card's own input blocks. Ignored by a pay or handoff button.

Response

OK.

okboolean
dispatched'pay' | 'handoff' | 'signup' | 'link' | 'interaction'
transfer_request_idstring
active_agent_idstring

Changes

No recorded changes to this operation across all 3 revisions of this API.