Submit agent workspace questionnaire answers

Public, unauthenticated submission endpoint for the UX research questionnaire. Stores answers, respondent info, workflow-posture tallies, and link/query-param tracking metadata in ux_research_survey_responses. Includes honeypot spam filtering and per-IP throttling.

POST

https://api.channelautomation.com/research/agent-workspace

Request body JSON required

answers
array of
object
required
- n
  optional
  integer
- q
  optional
  string
- a
  optional
  array of
  string
}
respondent
optional
object
- name
  optional
  string
- company
  optional
  string
- email
  optional
  string
}
posture
optional
object
Directional workflow-posture tallies (inbox/queue/board)
answered_count
optional
integer
meta
optional
object
Client context (link query params, referrer, timezone, screen)

Returns

200

Submission stored

400

Invalid or empty submission

429

Too many submissions from this IP

500

Internal server error

JSON

error
optional
string
details
optional
string
success
optional
boolean

Submit agent workspace questionnaire answers

curl --request POST \
  --url https://api.channelautomation.com/research/agent-workspace \
  --header 'Content-Type: application/json' \
  --data '
{
  "respondent": {
    "name": "string",
    "company": "string",
    "email": "string"
  },
  "answers": [
    {
      "n": 0,
      "q": "string",
      "a": [
        "string"
      ]
    }
  ],
  "posture": {},
  "answered_count": 0,
  "meta": {}
}
'

const url = 'https://api.channelautomation.com/research/agent-workspace';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    respondent: {name: 'string', company: 'string', email: 'string'},
    answers: [{n: 0, q: 'string', a: ['string']}],
    posture: {},
    answered_count: 0,
    meta: {}
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/research/agent-workspace"

payload = {
    "respondent": {
        "name": "string",
        "company": "string",
        "email": "string"
    },
    "answers": [
        {
            "n": 0,
            "q": "string",
            "a": ["string"]
        }
    ],
    "posture": {},
    "answered_count": 0,
    "meta": {}
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Response example

{
  "error": "Internal server error",
  "details": "string",
  "success": false
}