curl --request PATCH \
  --url https://app.gaintrace.com/api/v1/surveys/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Relationship NPS, Q4",
  "cooldownDays": 60
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'Relationship NPS, Q4', cooldownDays: 60})
};

fetch('https://app.gaintrace.com/api/v1/surveys/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.gaintrace.com/api/v1/surveys/{id}"

payload = {
    "name": "Relationship NPS, Q4",
    "cooldownDays": 60
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "id": "7b6f2c1e-4d3a-4b5c-9e8f-1a2b3c4d5e6f",
    "name": "Relationship NPS, Q4",
    "measure": "nps",
    "status": "draft",
    "questions": [
      {
        "text": "How likely are you to recommend us to a colleague?",
        "type": "rating",
        "required": true
      },
      {
        "text": "What is the main reason for your score?",
        "type": "text",
        "required": false
      }
    ],
    "settings": {
      "thankYouTitle": "Thank you",
      "reminders": {
        "afterDays": 3,
        "max": 1
      }
    },
    "cooldownDays": 60,
    "createdAt": "2026-10-14T09:00:00.000Z",
    "updatedAt": "2026-10-14T09:00:00.000Z"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Invalid JSON body",
    "doc_url": "https://docs.gaintrace.com/errors#bad_request"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing Authorization header",
    "doc_url": "https://docs.gaintrace.com/errors#unauthorized"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Insufficient scope: write:companies required",
    "doc_url": "https://docs.gaintrace.com/errors#forbidden"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Company not found",
    "doc_url": "https://docs.gaintrace.com/errors#not_found"
  }
}

{
  "error": {
    "code": "unprocessable_entity",
    "message": "Request validation failed. name: name is required",
    "doc_url": "https://docs.gaintrace.com/errors#unprocessable_entity"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Can't accept more than 60 requests a minute from one API key. Retry in 23 seconds.",
    "doc_url": "https://docs.gaintrace.com/errors#rate_limit_exceeded"
  }
}

{
  "error": {
    "code": "internal_server_error",
    "message": "Something went wrong. Try again in a moment.",
    "doc_url": "https://docs.gaintrace.com/errors#internal_server_error"
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "We had trouble reaching the database. Try again in a moment.",
    "doc_url": "https://docs.gaintrace.com/errors#service_unavailable"
  }
}

{
  "error": {
    "code": "gateway_timeout",
    "message": "The request timed out. Try again in a moment.",
    "doc_url": "https://docs.gaintrace.com/errors#gateway_timeout"
  }
}