Asks

Answer an ask

single_choice / permission_request: action_id. multi_choice: values.option_ids. form: values keyed by field id. free_text: values.text. The first answer wins; later ones get 409 with the current state in custom_error.ask.

post/v5/asks/{id}/answer

Request

  • Base URL: https://api.carbonvoice.app
  • URL: https://api.carbonvoice.app/v5/asks/{id}/answer
  • Auth: one of:
    • API key in header pxtoken
    • OAuth 2 (implicit, authorization URL https://api.carbonvoice.app/oauth/authorize)

Path parameters

idstring required

Request body

action_idstring

The chosen option id

valuesobject

Structured answer values (depends on the ask type)

Response

idstring required
conversation_idstring required
message_idstring required

The anchor message

creator_idstring required
creator_kind'agent' | 'user' required
type'single_choice' | 'multi_choice' | 'form' | 'free_text' | 'permission_request' | 'connect_account' required
payloadobject required

{ question, options?: [{ id, label }], form?: { fields: [{ id, label, required? }] }, connect?: { mode: "connect" | "reconnect", providers: [{ id, label }] }, details?: [{ label, value }] }

audienceobject required

"conversation" or { users: [ids] } — who may see the ask

respondersobject required

"any" or { users: [ids] } — who may answer the ask

response_mode'single' | 'per_user' required
status'pending' | 'answered' | 'expired' | 'canceled' required

Effective status: a pending ask past expires_at is expired

expires_atstring date-time nullable
answered_bystring nullable
answerobject nullable

The winning answer of a single ask: { user_id, action_id?, values?, created_at }

resolved_atstring date-time nullable
created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.