API Documentation

API Endpoint

Survey Fields

Survey Fields

The Survey field object represents a question inside of a form within the application.

Data type

The data_type_id attribute can have one of the following integer values:

  • 1 (Text field)

  • 2 (Number field)

  • 3 (Select field)

  • 4 (Date field)

  • 5 (Multiple select field)

  • 7 (Attachment field)

Formatting type

The formatting_type_id attribute can have one of the following integer values:

  • 1 (decimal)

  • 2 (percentage)

Supported filter params

  • archived (‘true’ or ‘false’)

  • global (‘true’ or ‘false’)

  • name

  • origin_field_id

  • project_id

  • survey_id

GET /api/v2/survey_fields
Requestsreturns survey_fields

GET  /api/v2/survey_fields

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": [
    {
      "id": "38",
      "type": "survey_fields",
      "attributes": {
        "created_at": "2025-11-15T05:21:15.435+01:00",
        "updated_at": "2025-11-15T05:21:15.435+01:00",
        "name": "Custom field no.33",
        "data_type_id": 1,
        "required": false,
        "description": null,
        "archived_at": null,
        "aggregation_type_id": null,
        "formatting_type_id": null,
        "global": null,
        "show_in_add_edit_views": true,
        "sensitive": false,
        "position": 1,
        "quick_add_enabled": false,
        "customizable_type": "survey_responses"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2425"
          }
        },
        "survey": {
          "data": {
            "type": "surveys",
            "id": "19"
          }
        },
        "origin_field": {
          "data": null
        },
        "options": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        }
      }
    }
  ],
  "included": [
    {
      "id": "19",
      "type": "surveys",
      "attributes": {
        "title": "Survey16",
        "description": null,
        "public_uuid": "4088bc96-db6f-5a70-b8ff-b3635debc7ed",
        "submission_access": "nobody",
        "created_at": "2025-11-15T05:21:15.429+01:00",
        "updated_at": "2025-11-15T05:21:15.436+01:00"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2425"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "1864"
          }
        },
        "creator": {
          "data": {
            "type": "people",
            "id": "9069"
          }
        },
        "updater": {
          "data": {
            "type": "people",
            "id": "9069"
          }
        }
      }
    },
    {
      "id": "1864",
      "type": "projects",
      "attributes": {
        "name": "test project",
        "number": "1",
        "preferences": {},
        "project_number": "1",
        "project_type_id": 2,
        "project_color_id": null,
        "last_activity_at": "2025-11-15T05:21:15.000+01:00",
        "tag_colors": {},
        "archived_at": null,
        "created_at": "2025-11-15T05:21:15.416+01:00",
        "template": false,
        "duplication_status": "idle",
        "custom_fields": null,
        "task_custom_fields_ids": null,
        "task_custom_fields_positions": null,
        "page_custom_fields_ids": null,
        "page_custom_fields_positions": null,
        "sample_data": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2425"
          }
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6675"
          }
        },
        "project_manager": {
          "data": {
            "type": "people",
            "id": "9070"
          }
        },
        "last_actor": {
          "data": {
            "type": "people",
            "id": "9069"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2321"
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "template_object": {
          "data": null
        }
      }
    },
    {
      "id": "9069",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8952@email.com",
        "first_name": "name",
        "last_name": "surname",
        "nickname": null,
        "original_avatar_url": null,
        "role_id": 1,
        "status_emoji": null,
        "status_expires_at": null,
        "status_text": null,
        "time_off_status_sync": true,
        "title": null,
        "archived_at": null,
        "autotracking": false,
        "joined_at": null,
        "last_seen_at": null,
        "invited_at": null,
        "is_user": true,
        "user_id": 9030,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-11-15T05:21:15.377+01:00",
        "placeholder": false,
        "color_id": null,
        "sample_data": false,
        "time_unlocked": false,
        "time_unlocked_on": null,
        "time_unlocked_start_date": null,
        "time_unlocked_end_date": null,
        "time_unlocked_period_id": null,
        "time_unlocked_interval": null,
        "last_activity_at": null,
        "two_factor_auth": false,
        "availabilities": "[]",
        "external_id": null,
        "external_sync": false,
        "hrm_type_id": 1,
        "champion": false,
        "timesheet_submission_disabled": false,
        "offboarding_status": "not_initiated",
        "offboarding_id": null,
        "time_tracking_policy_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2425"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": null
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9372"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "6675",
      "type": "companies",
      "attributes": {
        "name": "Client4328",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-11-15T05:21:15.412+01:00",
        "last_activity_at": "2025-11-15T05:21:15.412+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "CLIE4332",
        "domain": null,
        "projectless_budgets": false,
        "leitweg_id": null,
        "buyer_reference": null,
        "peppol_id": null,
        "default_subsidiary_id": null,
        "default_tax_rate_id": null,
        "default_document_type_id": null,
        "due_days": null,
        "tag_list": [],
        "contact": {},
        "sample_data": false,
        "settings": {},
        "external_id": null,
        "external_sync": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2425"
          }
        },
        "default_subsidiary": {
          "meta": {
            "included": false
          }
        },
        "default_tax_rate": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "integration_exporter_configuration": {
          "meta": {
            "included": false
          }
        },
        "einvoice_identity": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9070",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8953@email.com",
        "first_name": "name",
        "last_name": "surname",
        "nickname": null,
        "original_avatar_url": null,
        "role_id": 3,
        "status_emoji": null,
        "status_expires_at": null,
        "status_text": null,
        "time_off_status_sync": true,
        "title": null,
        "archived_at": null,
        "autotracking": false,
        "joined_at": null,
        "last_seen_at": null,
        "invited_at": "2025-11-15T05:21:00.000+01:00",
        "is_user": true,
        "user_id": 9031,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-11-15T05:21:15.399+01:00",
        "placeholder": false,
        "color_id": null,
        "sample_data": false,
        "time_unlocked": false,
        "time_unlocked_on": null,
        "time_unlocked_start_date": null,
        "time_unlocked_end_date": null,
        "time_unlocked_period_id": null,
        "time_unlocked_interval": null,
        "last_activity_at": "2025-11-15T05:21:15.399+01:00",
        "two_factor_auth": false,
        "availabilities": "[]",
        "external_id": null,
        "external_sync": false,
        "hrm_type_id": 1,
        "champion": false,
        "timesheet_submission_disabled": false,
        "offboarding_status": "not_initiated",
        "offboarding_id": null,
        "time_tracking_policy_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2425"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6674"
          }
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9373"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "2321",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2425"
          }
        },
        "workflow_statuses": {
          "data": [
            {
              "type": "workflow_statuses",
              "id": "2957"
            }
          ]
        }
      }
    },
    {
      "id": "9372",
      "type": "roles",
      "attributes": {
        "base_role_id": 1,
        "description": "test description",
        "name": "test_role",
        "people_count": 1,
        "permissions": {},
        "editable_by_user": false,
        "user_type_id": 1
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2425"
          }
        }
      }
    },
    {
      "id": "6674",
      "type": "companies",
      "attributes": {
        "name": "Organization2426",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-11-15T05:21:15.385+01:00",
        "last_activity_at": "2025-11-15T05:21:15.385+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "ORGA",
        "domain": null,
        "projectless_budgets": false,
        "leitweg_id": null,
        "buyer_reference": null,
        "peppol_id": null,
        "default_subsidiary_id": null,
        "default_tax_rate_id": null,
        "default_document_type_id": null,
        "due_days": null,
        "tag_list": [],
        "contact": {},
        "sample_data": false,
        "settings": {},
        "external_id": null,
        "external_sync": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2425"
          }
        },
        "default_subsidiary": {
          "meta": {
            "included": false
          }
        },
        "default_tax_rate": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "integration_exporter_configuration": {
          "meta": {
            "included": false
          }
        },
        "einvoice_identity": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9373",
      "type": "roles",
      "attributes": {
        "base_role_id": 3,
        "description": "test description",
        "name": "test_role",
        "people_count": 1,
        "permissions": {},
        "editable_by_user": false,
        "user_type_id": 1
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2425"
          }
        }
      }
    },
    {
      "id": "2957",
      "type": "workflow_statuses",
      "attributes": {
        "name": "Closed",
        "color_id": "1",
        "position": 1,
        "category_id": 3
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2425"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2321"
          }
        }
      }
    }
  ],
  "links": {
    "first": "http://api-test.productive.io/api/v2/survey_fields?page%5Bnumber%5D=1&page%5Bsize%5D=30",
    "last": "http://api-test.productive.io/api/v2/survey_fields?page%5Bnumber%5D=1&page%5Bsize%5D=30"
  },
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "page_size": 30,
    "max_page_size": 200
  }
}

Get survey fields
GET/api/v2/survey_fields

GET /api/v2/survey_fields/1
Requestsreturns survey_field

GET  /api/v2/survey_fields/40

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "40",
    "type": "survey_fields",
    "attributes": {
      "created_at": "2025-11-15T05:21:15.591+01:00",
      "updated_at": "2025-11-15T05:21:15.591+01:00",
      "name": "Custom field no.35",
      "data_type_id": 1,
      "required": false,
      "description": null,
      "archived_at": null,
      "aggregation_type_id": null,
      "formatting_type_id": null,
      "global": null,
      "show_in_add_edit_views": true,
      "sensitive": false,
      "position": 1,
      "quick_add_enabled": false,
      "customizable_type": "survey_responses"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "2426"
        }
      },
      "survey": {
        "data": {
          "type": "surveys",
          "id": "20"
        }
      },
      "origin_field": {
        "data": null
      },
      "options": {
        "data": []
      },
      "custom_field_people": {
        "data": []
      }
    }
  },
  "included": [
    {
      "id": "20",
      "type": "surveys",
      "attributes": {
        "title": "Survey17",
        "description": null,
        "public_uuid": "e645aa9c-55c4-5623-b75f-432fcfdf1330",
        "submission_access": "nobody",
        "created_at": "2025-11-15T05:21:15.585+01:00",
        "updated_at": "2025-11-15T05:21:15.592+01:00"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2426"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "1865"
          }
        },
        "creator": {
          "data": {
            "type": "people",
            "id": "9071"
          }
        },
        "updater": {
          "data": {
            "type": "people",
            "id": "9071"
          }
        }
      }
    },
    {
      "id": "1865",
      "type": "projects",
      "attributes": {
        "name": "test project",
        "number": "1",
        "preferences": {},
        "project_number": "1",
        "project_type_id": 2,
        "project_color_id": null,
        "last_activity_at": "2025-11-15T05:21:15.000+01:00",
        "tag_colors": {},
        "archived_at": null,
        "created_at": "2025-11-15T05:21:15.572+01:00",
        "template": false,
        "duplication_status": "idle",
        "custom_fields": null,
        "task_custom_fields_ids": null,
        "task_custom_fields_positions": null,
        "page_custom_fields_ids": null,
        "page_custom_fields_positions": null,
        "sample_data": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2426"
          }
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6677"
          }
        },
        "project_manager": {
          "data": {
            "type": "people",
            "id": "9072"
          }
        },
        "last_actor": {
          "data": {
            "type": "people",
            "id": "9071"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2322"
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "template_object": {
          "data": null
        }
      }
    },
    {
      "id": "9071",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8954@email.com",
        "first_name": "name",
        "last_name": "surname",
        "nickname": null,
        "original_avatar_url": null,
        "role_id": 1,
        "status_emoji": null,
        "status_expires_at": null,
        "status_text": null,
        "time_off_status_sync": true,
        "title": null,
        "archived_at": null,
        "autotracking": false,
        "joined_at": null,
        "last_seen_at": null,
        "invited_at": null,
        "is_user": true,
        "user_id": 9032,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-11-15T05:21:15.534+01:00",
        "placeholder": false,
        "color_id": null,
        "sample_data": false,
        "time_unlocked": false,
        "time_unlocked_on": null,
        "time_unlocked_start_date": null,
        "time_unlocked_end_date": null,
        "time_unlocked_period_id": null,
        "time_unlocked_interval": null,
        "last_activity_at": null,
        "two_factor_auth": false,
        "availabilities": "[]",
        "external_id": null,
        "external_sync": false,
        "hrm_type_id": 1,
        "champion": false,
        "timesheet_submission_disabled": false,
        "offboarding_status": "not_initiated",
        "offboarding_id": null,
        "time_tracking_policy_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2426"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": null
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9374"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "6677",
      "type": "companies",
      "attributes": {
        "name": "Client4329",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-11-15T05:21:15.568+01:00",
        "last_activity_at": "2025-11-15T05:21:15.568+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "CLIE4333",
        "domain": null,
        "projectless_budgets": false,
        "leitweg_id": null,
        "buyer_reference": null,
        "peppol_id": null,
        "default_subsidiary_id": null,
        "default_tax_rate_id": null,
        "default_document_type_id": null,
        "due_days": null,
        "tag_list": [],
        "contact": {},
        "sample_data": false,
        "settings": {},
        "external_id": null,
        "external_sync": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2426"
          }
        },
        "default_subsidiary": {
          "meta": {
            "included": false
          }
        },
        "default_tax_rate": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "integration_exporter_configuration": {
          "meta": {
            "included": false
          }
        },
        "einvoice_identity": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9072",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8955@email.com",
        "first_name": "name",
        "last_name": "surname",
        "nickname": null,
        "original_avatar_url": null,
        "role_id": 3,
        "status_emoji": null,
        "status_expires_at": null,
        "status_text": null,
        "time_off_status_sync": true,
        "title": null,
        "archived_at": null,
        "autotracking": false,
        "joined_at": null,
        "last_seen_at": null,
        "invited_at": "2025-11-15T05:21:00.000+01:00",
        "is_user": true,
        "user_id": 9033,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-11-15T05:21:15.556+01:00",
        "placeholder": false,
        "color_id": null,
        "sample_data": false,
        "time_unlocked": false,
        "time_unlocked_on": null,
        "time_unlocked_start_date": null,
        "time_unlocked_end_date": null,
        "time_unlocked_period_id": null,
        "time_unlocked_interval": null,
        "last_activity_at": "2025-11-15T05:21:15.556+01:00",
        "two_factor_auth": false,
        "availabilities": "[]",
        "external_id": null,
        "external_sync": false,
        "hrm_type_id": 1,
        "champion": false,
        "timesheet_submission_disabled": false,
        "offboarding_status": "not_initiated",
        "offboarding_id": null,
        "time_tracking_policy_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2426"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6676"
          }
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9375"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "2322",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2426"
          }
        },
        "workflow_statuses": {
          "data": [
            {
              "type": "workflow_statuses",
              "id": "2958"
            }
          ]
        }
      }
    },
    {
      "id": "9374",
      "type": "roles",
      "attributes": {
        "base_role_id": 1,
        "description": "test description",
        "name": "test_role",
        "people_count": 1,
        "permissions": {},
        "editable_by_user": false,
        "user_type_id": 1
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2426"
          }
        }
      }
    },
    {
      "id": "6676",
      "type": "companies",
      "attributes": {
        "name": "Organization2427",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-11-15T05:21:15.543+01:00",
        "last_activity_at": "2025-11-15T05:21:15.543+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "ORGA",
        "domain": null,
        "projectless_budgets": false,
        "leitweg_id": null,
        "buyer_reference": null,
        "peppol_id": null,
        "default_subsidiary_id": null,
        "default_tax_rate_id": null,
        "default_document_type_id": null,
        "due_days": null,
        "tag_list": [],
        "contact": {},
        "sample_data": false,
        "settings": {},
        "external_id": null,
        "external_sync": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2426"
          }
        },
        "default_subsidiary": {
          "meta": {
            "included": false
          }
        },
        "default_tax_rate": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "integration_exporter_configuration": {
          "meta": {
            "included": false
          }
        },
        "einvoice_identity": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9375",
      "type": "roles",
      "attributes": {
        "base_role_id": 3,
        "description": "test description",
        "name": "test_role",
        "people_count": 1,
        "permissions": {},
        "editable_by_user": false,
        "user_type_id": 1
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2426"
          }
        }
      }
    },
    {
      "id": "2958",
      "type": "workflow_statuses",
      "attributes": {
        "name": "Closed",
        "color_id": "1",
        "position": 1,
        "category_id": 3
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2426"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2322"
          }
        }
      }
    }
  ],
  "meta": {}
}

Gets a survey field
GET/api/v2/survey_fields/{id}

URI Parameters
HideShow
id
number (required) Example: 1

survey field id

POST /api/v2/survey_fields
Requestscreates survey field when params validreturns errors when params invalid

POST  /api/v2/survey_fields

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "survey_fields",
    "attributes": {
      "name": "Just an another question for survey",
      "survey_id": 21,
      "customizable_type": "survey_responses",
      "data_type_id": 1
    }
  }
}
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "41",
    "type": "survey_fields",
    "attributes": {
      "created_at": "2025-11-15T05:21:15.731+01:00",
      "updated_at": "2025-11-15T05:21:15.731+01:00",
      "name": "Just an another question for survey",
      "data_type_id": 1,
      "required": false,
      "description": null,
      "archived_at": null,
      "aggregation_type_id": null,
      "formatting_type_id": null,
      "global": true,
      "show_in_add_edit_views": true,
      "sensitive": false,
      "position": 1,
      "quick_add_enabled": false,
      "customizable_type": "survey_responses"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "2427"
        }
      },
      "survey": {
        "data": {
          "type": "surveys",
          "id": "21"
        }
      },
      "origin_field": {
        "data": null
      },
      "options": {
        "data": []
      },
      "custom_field_people": {
        "data": []
      }
    }
  },
  "included": [
    {
      "id": "21",
      "type": "surveys",
      "attributes": {
        "title": "Survey18",
        "description": null,
        "public_uuid": "134ce334-2824-5508-9561-76e4e9eb2268",
        "submission_access": "nobody",
        "created_at": "2025-11-15T05:21:15.711+01:00",
        "updated_at": "2025-11-15T05:21:15.733+01:00"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2427"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "1866"
          }
        },
        "creator": {
          "data": {
            "type": "people",
            "id": "9073"
          }
        },
        "updater": {
          "data": {
            "type": "people",
            "id": "9073"
          }
        }
      }
    },
    {
      "id": "1866",
      "type": "projects",
      "attributes": {
        "name": "test project",
        "number": "1",
        "preferences": {},
        "project_number": "1",
        "project_type_id": 2,
        "project_color_id": null,
        "last_activity_at": "2025-11-15T05:21:15.000+01:00",
        "tag_colors": {},
        "archived_at": null,
        "created_at": "2025-11-15T05:21:15.699+01:00",
        "template": false,
        "duplication_status": "idle",
        "custom_fields": null,
        "task_custom_fields_ids": null,
        "task_custom_fields_positions": null,
        "page_custom_fields_ids": null,
        "page_custom_fields_positions": null,
        "sample_data": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2427"
          }
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6679"
          }
        },
        "project_manager": {
          "data": {
            "type": "people",
            "id": "9074"
          }
        },
        "last_actor": {
          "data": {
            "type": "people",
            "id": "9073"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2323"
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "template_object": {
          "data": null
        }
      }
    },
    {
      "id": "9073",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8956@email.com",
        "first_name": "name",
        "last_name": "surname",
        "nickname": null,
        "original_avatar_url": null,
        "role_id": 1,
        "status_emoji": null,
        "status_expires_at": null,
        "status_text": null,
        "time_off_status_sync": true,
        "title": null,
        "archived_at": null,
        "autotracking": false,
        "joined_at": null,
        "last_seen_at": null,
        "invited_at": null,
        "is_user": true,
        "user_id": 9034,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-11-15T05:21:15.661+01:00",
        "placeholder": false,
        "color_id": null,
        "sample_data": false,
        "time_unlocked": false,
        "time_unlocked_on": null,
        "time_unlocked_start_date": null,
        "time_unlocked_end_date": null,
        "time_unlocked_period_id": null,
        "time_unlocked_interval": null,
        "last_activity_at": null,
        "two_factor_auth": false,
        "availabilities": "[]",
        "external_id": null,
        "external_sync": false,
        "hrm_type_id": 1,
        "champion": false,
        "timesheet_submission_disabled": false,
        "offboarding_status": "not_initiated",
        "offboarding_id": null,
        "time_tracking_policy_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2427"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": null
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9376"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "6679",
      "type": "companies",
      "attributes": {
        "name": "Client4330",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-11-15T05:21:15.695+01:00",
        "last_activity_at": "2025-11-15T05:21:15.695+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "CLIE4334",
        "domain": null,
        "projectless_budgets": false,
        "leitweg_id": null,
        "buyer_reference": null,
        "peppol_id": null,
        "default_subsidiary_id": null,
        "default_tax_rate_id": null,
        "default_document_type_id": null,
        "due_days": null,
        "tag_list": [],
        "contact": {},
        "sample_data": false,
        "settings": {},
        "external_id": null,
        "external_sync": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2427"
          }
        },
        "default_subsidiary": {
          "meta": {
            "included": false
          }
        },
        "default_tax_rate": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "integration_exporter_configuration": {
          "meta": {
            "included": false
          }
        },
        "einvoice_identity": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9074",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8957@email.com",
        "first_name": "name",
        "last_name": "surname",
        "nickname": null,
        "original_avatar_url": null,
        "role_id": 3,
        "status_emoji": null,
        "status_expires_at": null,
        "status_text": null,
        "time_off_status_sync": true,
        "title": null,
        "archived_at": null,
        "autotracking": false,
        "joined_at": null,
        "last_seen_at": null,
        "invited_at": "2025-11-15T05:21:00.000+01:00",
        "is_user": true,
        "user_id": 9035,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-11-15T05:21:15.683+01:00",
        "placeholder": false,
        "color_id": null,
        "sample_data": false,
        "time_unlocked": false,
        "time_unlocked_on": null,
        "time_unlocked_start_date": null,
        "time_unlocked_end_date": null,
        "time_unlocked_period_id": null,
        "time_unlocked_interval": null,
        "last_activity_at": "2025-11-15T05:21:15.683+01:00",
        "two_factor_auth": false,
        "availabilities": "[]",
        "external_id": null,
        "external_sync": false,
        "hrm_type_id": 1,
        "champion": false,
        "timesheet_submission_disabled": false,
        "offboarding_status": "not_initiated",
        "offboarding_id": null,
        "time_tracking_policy_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2427"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6678"
          }
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9377"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "2323",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2427"
          }
        },
        "workflow_statuses": {
          "data": [
            {
              "type": "workflow_statuses",
              "id": "2959"
            }
          ]
        }
      }
    },
    {
      "id": "9376",
      "type": "roles",
      "attributes": {
        "base_role_id": 1,
        "description": "test description",
        "name": "test_role",
        "people_count": 1,
        "permissions": {},
        "editable_by_user": false,
        "user_type_id": 1
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2427"
          }
        }
      }
    },
    {
      "id": "6678",
      "type": "companies",
      "attributes": {
        "name": "Organization2428",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-11-15T05:21:15.669+01:00",
        "last_activity_at": "2025-11-15T05:21:15.669+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "ORGA",
        "domain": null,
        "projectless_budgets": false,
        "leitweg_id": null,
        "buyer_reference": null,
        "peppol_id": null,
        "default_subsidiary_id": null,
        "default_tax_rate_id": null,
        "default_document_type_id": null,
        "due_days": null,
        "tag_list": [],
        "contact": {},
        "sample_data": false,
        "settings": {},
        "external_id": null,
        "external_sync": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2427"
          }
        },
        "default_subsidiary": {
          "meta": {
            "included": false
          }
        },
        "default_tax_rate": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "integration_exporter_configuration": {
          "meta": {
            "included": false
          }
        },
        "einvoice_identity": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9377",
      "type": "roles",
      "attributes": {
        "base_role_id": 3,
        "description": "test description",
        "name": "test_role",
        "people_count": 1,
        "permissions": {},
        "editable_by_user": false,
        "user_type_id": 1
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2427"
          }
        }
      }
    },
    {
      "id": "2959",
      "type": "workflow_statuses",
      "attributes": {
        "name": "Closed",
        "color_id": "1",
        "position": 1,
        "category_id": 3
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2427"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2323"
          }
        }
      }
    }
  ],
  "meta": {}
}

POST  /api/v2/survey_fields

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "survey_fields",
    "attributes": {
      "name": "Just an another question for survey",
      "survey_id": 22,
      "customizable_type": "survey_responses",
      "data_type_id": null
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "source": {
        "pointer": "data/attributes/data_type_id"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "is not included in the list",
      "source": {
        "pointer": "data/attributes/data_type_id"
      }
    }
  ]
}

Creates a survey field
POST/api/v2/survey_fields

URI Parameters
HideShow
survey_id
number (required) Example: 1

survey id

data_type_id
number (required) Example: 1

data type id

name
string (required) Example: Survey+Field+name

survey field name

origin_field_id
number (optional) Example: 1

origin field id

PATCH /api/v2/survey_fields/1
Requestsupdates survey field when validreturns error

PATCH  /api/v2/survey_fields/42

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "survey_fields",
    "attributes": {
      "name": "New name"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "42",
    "type": "survey_fields",
    "attributes": {
      "created_at": "2025-11-15T05:21:15.930+01:00",
      "updated_at": "2025-11-15T05:21:15.943+01:00",
      "name": "New name",
      "data_type_id": 1,
      "required": false,
      "description": null,
      "archived_at": null,
      "aggregation_type_id": null,
      "formatting_type_id": null,
      "global": true,
      "show_in_add_edit_views": true,
      "sensitive": false,
      "position": 1,
      "quick_add_enabled": false,
      "customizable_type": "survey_responses"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "2429"
        }
      },
      "survey": {
        "data": {
          "type": "surveys",
          "id": "23"
        }
      },
      "origin_field": {
        "data": null
      },
      "options": {
        "data": []
      },
      "custom_field_people": {
        "data": []
      }
    }
  },
  "included": [
    {
      "id": "23",
      "type": "surveys",
      "attributes": {
        "title": "Survey20",
        "description": null,
        "public_uuid": "094f357f-1498-5694-8748-0c3c1714f940",
        "submission_access": "nobody",
        "created_at": "2025-11-15T05:21:15.924+01:00",
        "updated_at": "2025-11-15T05:21:15.944+01:00"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2429"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "1868"
          }
        },
        "creator": {
          "data": {
            "type": "people",
            "id": "9077"
          }
        },
        "updater": {
          "data": {
            "type": "people",
            "id": "9077"
          }
        }
      }
    },
    {
      "id": "1868",
      "type": "projects",
      "attributes": {
        "name": "test project",
        "number": "1",
        "preferences": {},
        "project_number": "1",
        "project_type_id": 2,
        "project_color_id": null,
        "last_activity_at": "2025-11-15T05:21:15.000+01:00",
        "tag_colors": {},
        "archived_at": null,
        "created_at": "2025-11-15T05:21:15.913+01:00",
        "template": false,
        "duplication_status": "idle",
        "custom_fields": null,
        "task_custom_fields_ids": null,
        "task_custom_fields_positions": null,
        "page_custom_fields_ids": null,
        "page_custom_fields_positions": null,
        "sample_data": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2429"
          }
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6683"
          }
        },
        "project_manager": {
          "data": {
            "type": "people",
            "id": "9078"
          }
        },
        "last_actor": {
          "data": {
            "type": "people",
            "id": "9077"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2325"
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "template_object": {
          "data": null
        }
      }
    },
    {
      "id": "9077",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8960@email.com",
        "first_name": "name",
        "last_name": "surname",
        "nickname": null,
        "original_avatar_url": null,
        "role_id": 1,
        "status_emoji": null,
        "status_expires_at": null,
        "status_text": null,
        "time_off_status_sync": true,
        "title": null,
        "archived_at": null,
        "autotracking": false,
        "joined_at": null,
        "last_seen_at": null,
        "invited_at": null,
        "is_user": true,
        "user_id": 9038,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-11-15T05:21:15.877+01:00",
        "placeholder": false,
        "color_id": null,
        "sample_data": false,
        "time_unlocked": false,
        "time_unlocked_on": null,
        "time_unlocked_start_date": null,
        "time_unlocked_end_date": null,
        "time_unlocked_period_id": null,
        "time_unlocked_interval": null,
        "last_activity_at": null,
        "two_factor_auth": false,
        "availabilities": "[]",
        "external_id": null,
        "external_sync": false,
        "hrm_type_id": 1,
        "champion": false,
        "timesheet_submission_disabled": false,
        "offboarding_status": "not_initiated",
        "offboarding_id": null,
        "time_tracking_policy_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2429"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": null
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9380"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "6683",
      "type": "companies",
      "attributes": {
        "name": "Client4332",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-11-15T05:21:15.909+01:00",
        "last_activity_at": "2025-11-15T05:21:15.909+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "CLIE4336",
        "domain": null,
        "projectless_budgets": false,
        "leitweg_id": null,
        "buyer_reference": null,
        "peppol_id": null,
        "default_subsidiary_id": null,
        "default_tax_rate_id": null,
        "default_document_type_id": null,
        "due_days": null,
        "tag_list": [],
        "contact": {},
        "sample_data": false,
        "settings": {},
        "external_id": null,
        "external_sync": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2429"
          }
        },
        "default_subsidiary": {
          "meta": {
            "included": false
          }
        },
        "default_tax_rate": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "integration_exporter_configuration": {
          "meta": {
            "included": false
          }
        },
        "einvoice_identity": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9078",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8961@email.com",
        "first_name": "name",
        "last_name": "surname",
        "nickname": null,
        "original_avatar_url": null,
        "role_id": 3,
        "status_emoji": null,
        "status_expires_at": null,
        "status_text": null,
        "time_off_status_sync": true,
        "title": null,
        "archived_at": null,
        "autotracking": false,
        "joined_at": null,
        "last_seen_at": null,
        "invited_at": "2025-11-15T05:21:00.000+01:00",
        "is_user": true,
        "user_id": 9039,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-11-15T05:21:15.897+01:00",
        "placeholder": false,
        "color_id": null,
        "sample_data": false,
        "time_unlocked": false,
        "time_unlocked_on": null,
        "time_unlocked_start_date": null,
        "time_unlocked_end_date": null,
        "time_unlocked_period_id": null,
        "time_unlocked_interval": null,
        "last_activity_at": "2025-11-15T05:21:15.897+01:00",
        "two_factor_auth": false,
        "availabilities": "[]",
        "external_id": null,
        "external_sync": false,
        "hrm_type_id": 1,
        "champion": false,
        "timesheet_submission_disabled": false,
        "offboarding_status": "not_initiated",
        "offboarding_id": null,
        "time_tracking_policy_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2429"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6682"
          }
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9381"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "2325",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2429"
          }
        },
        "workflow_statuses": {
          "data": [
            {
              "type": "workflow_statuses",
              "id": "2961"
            }
          ]
        }
      }
    },
    {
      "id": "9380",
      "type": "roles",
      "attributes": {
        "base_role_id": 1,
        "description": "test description",
        "name": "test_role",
        "people_count": 1,
        "permissions": {},
        "editable_by_user": false,
        "user_type_id": 1
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2429"
          }
        }
      }
    },
    {
      "id": "6682",
      "type": "companies",
      "attributes": {
        "name": "Organization2430",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-11-15T05:21:15.885+01:00",
        "last_activity_at": "2025-11-15T05:21:15.885+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "ORGA",
        "domain": null,
        "projectless_budgets": false,
        "leitweg_id": null,
        "buyer_reference": null,
        "peppol_id": null,
        "default_subsidiary_id": null,
        "default_tax_rate_id": null,
        "default_document_type_id": null,
        "due_days": null,
        "tag_list": [],
        "contact": {},
        "sample_data": false,
        "settings": {},
        "external_id": null,
        "external_sync": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2429"
          }
        },
        "default_subsidiary": {
          "meta": {
            "included": false
          }
        },
        "default_tax_rate": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "integration_exporter_configuration": {
          "meta": {
            "included": false
          }
        },
        "einvoice_identity": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9381",
      "type": "roles",
      "attributes": {
        "base_role_id": 3,
        "description": "test description",
        "name": "test_role",
        "people_count": 1,
        "permissions": {},
        "editable_by_user": false,
        "user_type_id": 1
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2429"
          }
        }
      }
    },
    {
      "id": "2961",
      "type": "workflow_statuses",
      "attributes": {
        "name": "Closed",
        "color_id": "1",
        "position": 1,
        "category_id": 3
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2429"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2325"
          }
        }
      }
    }
  ],
  "meta": {}
}

PATCH  /api/v2/survey_fields/43

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "survey_fields",
    "attributes": {
      "name": null
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "source": {
        "pointer": "data/attributes/name"
      }
    }
  ]
}

Updates a survey field
PATCH/api/v2/survey_fields/{id}

URI Parameters
HideShow
id
number (required) Example: 1

survey field id

PATCH /api/v2/survey_fields/1/archive
Requestsarchives survey field

PATCH  /api/v2/survey_fields/44/archive

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "44",
    "type": "survey_fields",
    "attributes": {
      "created_at": "2025-11-15T05:21:16.161+01:00",
      "updated_at": "2025-11-15T05:21:16.184+01:00",
      "name": "Custom field no.36",
      "data_type_id": 3,
      "required": false,
      "description": null,
      "archived_at": "2025-11-15T05:21:16.000+01:00",
      "aggregation_type_id": null,
      "formatting_type_id": null,
      "global": null,
      "show_in_add_edit_views": true,
      "sensitive": false,
      "position": 1,
      "quick_add_enabled": false,
      "customizable_type": "survey_responses"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "2431"
        }
      },
      "survey": {
        "data": {
          "type": "surveys",
          "id": "25"
        }
      },
      "origin_field": {
        "data": null
      },
      "options": {
        "data": [
          {
            "type": "survey_field_options",
            "id": "18"
          },
          {
            "type": "survey_field_options",
            "id": "19"
          },
          {
            "type": "survey_field_options",
            "id": "20"
          }
        ]
      },
      "custom_field_people": {
        "data": []
      }
    }
  },
  "included": [
    {
      "id": "25",
      "type": "surveys",
      "attributes": {
        "title": "Survey22",
        "description": null,
        "public_uuid": "e360828e-9189-500d-a046-29a666d24a91",
        "submission_access": "nobody",
        "created_at": "2025-11-15T05:21:16.155+01:00",
        "updated_at": "2025-11-15T05:21:16.186+01:00"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "1870"
          }
        },
        "creator": {
          "data": {
            "type": "people",
            "id": "9081"
          }
        },
        "updater": {
          "data": {
            "type": "people",
            "id": "9081"
          }
        }
      }
    },
    {
      "id": "18",
      "type": "survey_field_options",
      "attributes": {
        "name": "High",
        "archived_at": "2025-11-15T05:21:16.000+01:00",
        "position": 1,
        "color_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        },
        "survey_field": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "19",
      "type": "survey_field_options",
      "attributes": {
        "name": "High",
        "archived_at": "2025-11-15T05:21:16.000+01:00",
        "position": 1,
        "color_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        },
        "survey_field": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "20",
      "type": "survey_field_options",
      "attributes": {
        "name": "High",
        "archived_at": "2025-11-15T05:21:16.000+01:00",
        "position": 1,
        "color_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        },
        "survey_field": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "1870",
      "type": "projects",
      "attributes": {
        "name": "test project",
        "number": "1",
        "preferences": {},
        "project_number": "1",
        "project_type_id": 2,
        "project_color_id": null,
        "last_activity_at": "2025-11-15T05:21:16.000+01:00",
        "tag_colors": {},
        "archived_at": null,
        "created_at": "2025-11-15T05:21:16.144+01:00",
        "template": false,
        "duplication_status": "idle",
        "custom_fields": null,
        "task_custom_fields_ids": null,
        "task_custom_fields_positions": null,
        "page_custom_fields_ids": null,
        "page_custom_fields_positions": null,
        "sample_data": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6687"
          }
        },
        "project_manager": {
          "data": {
            "type": "people",
            "id": "9082"
          }
        },
        "last_actor": {
          "data": {
            "type": "people",
            "id": "9081"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2327"
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "template_object": {
          "data": null
        }
      }
    },
    {
      "id": "9081",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8964@email.com",
        "first_name": "name",
        "last_name": "surname",
        "nickname": null,
        "original_avatar_url": null,
        "role_id": 1,
        "status_emoji": null,
        "status_expires_at": null,
        "status_text": null,
        "time_off_status_sync": true,
        "title": null,
        "archived_at": null,
        "autotracking": false,
        "joined_at": null,
        "last_seen_at": null,
        "invited_at": null,
        "is_user": true,
        "user_id": 9042,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-11-15T05:21:16.093+01:00",
        "placeholder": false,
        "color_id": null,
        "sample_data": false,
        "time_unlocked": false,
        "time_unlocked_on": null,
        "time_unlocked_start_date": null,
        "time_unlocked_end_date": null,
        "time_unlocked_period_id": null,
        "time_unlocked_interval": null,
        "last_activity_at": null,
        "two_factor_auth": false,
        "availabilities": "[]",
        "external_id": null,
        "external_sync": false,
        "hrm_type_id": 1,
        "champion": false,
        "timesheet_submission_disabled": false,
        "offboarding_status": "not_initiated",
        "offboarding_id": null,
        "time_tracking_policy_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": null
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9384"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "6687",
      "type": "companies",
      "attributes": {
        "name": "Client4334",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-11-15T05:21:16.140+01:00",
        "last_activity_at": "2025-11-15T05:21:16.140+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "CLIE4338",
        "domain": null,
        "projectless_budgets": false,
        "leitweg_id": null,
        "buyer_reference": null,
        "peppol_id": null,
        "default_subsidiary_id": null,
        "default_tax_rate_id": null,
        "default_document_type_id": null,
        "due_days": null,
        "tag_list": [],
        "contact": {},
        "sample_data": false,
        "settings": {},
        "external_id": null,
        "external_sync": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        },
        "default_subsidiary": {
          "meta": {
            "included": false
          }
        },
        "default_tax_rate": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "integration_exporter_configuration": {
          "meta": {
            "included": false
          }
        },
        "einvoice_identity": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9082",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8965@email.com",
        "first_name": "name",
        "last_name": "surname",
        "nickname": null,
        "original_avatar_url": null,
        "role_id": 3,
        "status_emoji": null,
        "status_expires_at": null,
        "status_text": null,
        "time_off_status_sync": true,
        "title": null,
        "archived_at": null,
        "autotracking": false,
        "joined_at": null,
        "last_seen_at": null,
        "invited_at": "2025-11-15T05:21:00.000+01:00",
        "is_user": true,
        "user_id": 9043,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-11-15T05:21:16.128+01:00",
        "placeholder": false,
        "color_id": null,
        "sample_data": false,
        "time_unlocked": false,
        "time_unlocked_on": null,
        "time_unlocked_start_date": null,
        "time_unlocked_end_date": null,
        "time_unlocked_period_id": null,
        "time_unlocked_interval": null,
        "last_activity_at": "2025-11-15T05:21:16.128+01:00",
        "two_factor_auth": false,
        "availabilities": "[]",
        "external_id": null,
        "external_sync": false,
        "hrm_type_id": 1,
        "champion": false,
        "timesheet_submission_disabled": false,
        "offboarding_status": "not_initiated",
        "offboarding_id": null,
        "time_tracking_policy_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6686"
          }
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9385"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "2327",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        },
        "workflow_statuses": {
          "data": [
            {
              "type": "workflow_statuses",
              "id": "2963"
            }
          ]
        }
      }
    },
    {
      "id": "9384",
      "type": "roles",
      "attributes": {
        "base_role_id": 1,
        "description": "test description",
        "name": "test_role",
        "people_count": 1,
        "permissions": {},
        "editable_by_user": false,
        "user_type_id": 1
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        }
      }
    },
    {
      "id": "6686",
      "type": "companies",
      "attributes": {
        "name": "Organization2432",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-11-15T05:21:16.100+01:00",
        "last_activity_at": "2025-11-15T05:21:16.100+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "ORGA",
        "domain": null,
        "projectless_budgets": false,
        "leitweg_id": null,
        "buyer_reference": null,
        "peppol_id": null,
        "default_subsidiary_id": null,
        "default_tax_rate_id": null,
        "default_document_type_id": null,
        "due_days": null,
        "tag_list": [],
        "contact": {},
        "sample_data": false,
        "settings": {},
        "external_id": null,
        "external_sync": false
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        },
        "default_subsidiary": {
          "meta": {
            "included": false
          }
        },
        "default_tax_rate": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "integration_exporter_configuration": {
          "meta": {
            "included": false
          }
        },
        "einvoice_identity": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9385",
      "type": "roles",
      "attributes": {
        "base_role_id": 3,
        "description": "test description",
        "name": "test_role",
        "people_count": 1,
        "permissions": {},
        "editable_by_user": false,
        "user_type_id": 1
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        }
      }
    },
    {
      "id": "2963",
      "type": "workflow_statuses",
      "attributes": {
        "name": "Closed",
        "color_id": "1",
        "position": 1,
        "category_id": 3
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2431"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2327"
          }
        }
      }
    }
  ],
  "meta": {}
}

Archives a survey field
PATCH/api/v2/survey_fields/{id}/archive

URI Parameters
HideShow
id
number (required) Example: 1

survey field id

Generated by aglio on 15 Nov 2025