Update a response

curl --request PATCH \
  --url https://app.usertick.com/api/public/v1/responses/{responseId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "in_progress",
  "assignees": [
    "66666666-6666-4666-8666-666666666666"
  ]
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({status: 'in_progress', assignees: ['66666666-6666-4666-8666-666666666666']})
};

fetch('https://app.usertick.com/api/public/v1/responses/{responseId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.usertick.com/api/public/v1/responses/{responseId}"

payload = {
    "status": "in_progress",
    "assignees": ["66666666-6666-4666-8666-666666666666"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "id": "9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
  "url": "https://app.usertick.com/inbox/9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
  "survey": {
    "id": "11111111-1111-4111-8111-111111111111",
    "name": "Checkout feedback"
  },
  "site": {
    "id": "22222222-2222-4222-8222-222222222222",
    "domain": "shop.example.com"
  },
  "createdAt": "2026-09-30T10:00:00.123Z",
  "updatedAt": "2026-09-30T12:31:05.120Z",
  "source": "widget",
  "language": "en",
  "country": "US",
  "pageUrl": "https://shop.example.com/checkout",
  "device": {
    "type": "desktop",
    "browser": "Chrome",
    "os": "macOS"
  },
  "variant": null,
  "variantName": null,
  "contact": {
    "id": "77777777-7777-4777-8777-777777777777",
    "email": "[email protected]"
  },
  "respondent": {
    "userId": "user_8271",
    "anonymousId": "5f0c7a2b-8d4e-4c1a-9e3f-2b6d8a0c4e1f",
    "verified": true,
    "email": "[email protected]",
    "emailSource": "identify",
    "name": "Maya Chen",
    "company": "Example Inc.",
    "traits": {
      "company": "Example Inc.",
      "plan": "pro"
    },
    "traitsVerified": false,
    "contactQuestion": null,
    "contact": {
      "id": "77777777-7777-4777-8777-777777777777"
    }
  },
  "answers": [
    {
      "questionId": "q_nps",
      "question": "How likely are you to recommend us?",
      "type": "nps",
      "value": 4,
      "text": "4"
    },
    {
      "questionId": "q_comment",
      "question": "What went wrong?",
      "type": "text",
      "value": "Checkout rejects my card every time",
      "text": "Checkout rejects my card every time"
    }
  ],
  "answerText": {
    "q_nps": "4",
    "q_comment": "Checkout rejects my card every time"
  },
  "attachments": [],
  "status": "in_progress",
  "assignees": [
    {
      "id": "66666666-6666-4666-8666-666666666666",
      "name": "Ana Ruiz",
      "email": "[email protected]"
    }
  ],
  "ai": {
    "type": "bug",
    "urgency": "high",
    "theme": {
      "id": "44444444-4444-4444-8444-444444444444",
      "name": "Checkout errors"
    },
    "category": {
      "id": "55555555-5555-4555-8555-555555555555",
      "name": "Payments"
    },
    "sentiment": "negative",
    "analyzedAt": "2026-09-30T10:00:07.250Z",
    "corrected": false
  },
  "commentsCount": 2
}

PATCH

responses

{responseId}

Update a response

curl --request PATCH \
  --url https://app.usertick.com/api/public/v1/responses/{responseId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "in_progress",
  "assignees": [
    "66666666-6666-4666-8666-666666666666"
  ]
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({status: 'in_progress', assignees: ['66666666-6666-4666-8666-666666666666']})
};

fetch('https://app.usertick.com/api/public/v1/responses/{responseId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.usertick.com/api/public/v1/responses/{responseId}"

payload = {
    "status": "in_progress",
    "assignees": ["66666666-6666-4666-8666-666666666666"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "id": "9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
  "url": "https://app.usertick.com/inbox/9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
  "survey": {
    "id": "11111111-1111-4111-8111-111111111111",
    "name": "Checkout feedback"
  },
  "site": {
    "id": "22222222-2222-4222-8222-222222222222",
    "domain": "shop.example.com"
  },
  "createdAt": "2026-09-30T10:00:00.123Z",
  "updatedAt": "2026-09-30T12:31:05.120Z",
  "source": "widget",
  "language": "en",
  "country": "US",
  "pageUrl": "https://shop.example.com/checkout",
  "device": {
    "type": "desktop",
    "browser": "Chrome",
    "os": "macOS"
  },
  "variant": null,
  "variantName": null,
  "contact": {
    "id": "77777777-7777-4777-8777-777777777777",
    "email": "[email protected]"
  },
  "respondent": {
    "userId": "user_8271",
    "anonymousId": "5f0c7a2b-8d4e-4c1a-9e3f-2b6d8a0c4e1f",
    "verified": true,
    "email": "[email protected]",
    "emailSource": "identify",
    "name": "Maya Chen",
    "company": "Example Inc.",
    "traits": {
      "company": "Example Inc.",
      "plan": "pro"
    },
    "traitsVerified": false,
    "contactQuestion": null,
    "contact": {
      "id": "77777777-7777-4777-8777-777777777777"
    }
  },
  "answers": [
    {
      "questionId": "q_nps",
      "question": "How likely are you to recommend us?",
      "type": "nps",
      "value": 4,
      "text": "4"
    },
    {
      "questionId": "q_comment",
      "question": "What went wrong?",
      "type": "text",
      "value": "Checkout rejects my card every time",
      "text": "Checkout rejects my card every time"
    }
  ],
  "answerText": {
    "q_nps": "4",
    "q_comment": "Checkout rejects my card every time"
  },
  "attachments": [],
  "status": "in_progress",
  "assignees": [
    {
      "id": "66666666-6666-4666-8666-666666666666",
      "name": "Ana Ruiz",
      "email": "[email protected]"
    }
  ],
  "ai": {
    "type": "bug",
    "urgency": "high",
    "theme": {
      "id": "44444444-4444-4444-8444-444444444444",
      "name": "Checkout errors"
    },
    "category": {
      "id": "55555555-5555-4555-8555-555555555555",
      "name": "Payments"
    },
    "sentiment": "negative",
    "analyzedAt": "2026-09-30T10:00:07.250Z",
    "corrected": false
  },
  "commentsCount": 2
}

Authorizations

Authorization

string

header

required

An API key (utk_live_...) or an app's OAuth access token (uto_...).

Path Parameters

responseId

string<uuid>

required

A response id.

Body

application/json

Send at least one field. auto drops a correction and follows the analysis again.

status

enum<string>

Available options:

open,

planned,

in_progress,

resolved,

archived

type

enum<string>

Available options:

bug,

idea,

complaint,

question,

praise,

none,

auto

urgency

enum<string>

Available options:

high,

medium,

low,

auto

assignees

string<uuid>[]

Member ids that replace the current assignees; [] unassigns everyone. At most 500.

Maximum array length: 500

Response

The response after the change.

One response: what every response read returns and what every webhook delivery carries in data.

string<uuid>

required

The response's id (a UUID).

url

string<uri>

required

The response in the Usertick inbox.

survey

object

required

Show child attributes

site

object | null

required

Show child attributes

createdAt

string<date-time>

required

When the response was received.

Example:

"2026-09-30T10:00:00.000Z"

updatedAt

string<date-time>

required

The latest of: received, analyzed, and the last change a person or an integration made (status, type, urgency, assignees, notes, corrections).

Example:

"2026-09-30T10:00:00.000Z"

source

string | null

required

widget, link, email or api.

language

string | null

required

country

string | null

required

ISO 3166-1 alpha-2.

pageUrl

string | null

required

The page the response was sent from.

device

object | null

required

Show child attributes

variant

string | null

required

The ID of the survey variant the respondent saw (v_ followed by letters and digits); null when the respondent saw the survey without a variant.

variantName

string | null

required

The name of that variant, also for a variant the survey no longer has; null when variant is null or the variant has no name.

contact

object | null

required

Who answered, when known; null when nothing names them.

Show child attributes

respondent

object

required

Who answered. Always present; a field is null when unknown. Never sent to the AI.

Show child attributes

answers

object[]

required

Answered questions in survey order; answers to questions the survey no longer has come last.

Show child attributes

answerText

object

required

Question id to the answer's display text.

Show child attributes

attachments

object[]

required

Show child attributes

status

enum<string>

required

Available options:

open,

planned,

in_progress,

resolved,

archived

assignees

object[]

required

Show child attributes

object | null

required

The analysis. Null until analyzed, when the analysis was skipped or failed and nobody corrected it, and on every response.created delivery.

Show child attributes

commentsCount

integer

required

Notes on the timeline, deleted ones not counted.

JavaScript SDK

REST API

API reference

Webhooks

MCP

Update a response

Authorizations

Path Parameters

Body

Response