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-12-06T01:22:22.168+01:00",
        "updated_at": "2025-12-06T01:22:22.168+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": "2440"
          }
        },
        "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-12-06T01:22:22.162+01:00",
        "updated_at": "2025-12-06T01:22:22.168+01:00"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2440"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "1862"
          }
        },
        "creator": {
          "data": {
            "type": "people",
            "id": "9068"
          }
        },
        "updater": {
          "data": {
            "type": "people",
            "id": "9068"
          }
        }
      }
    },
    {
      "id": "1862",
      "type": "projects",
      "attributes": {
        "name": "test project",
        "number": "1",
        "preferences": {},
        "project_number": "1",
        "project_type_id": 2,
        "project_color_id": null,
        "last_activity_at": "2025-12-06T01:22:22.000+01:00",
        "tag_colors": {},
        "archived_at": null,
        "created_at": "2025-12-06T01:22:22.150+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": "2440"
          }
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6710"
          }
        },
        "project_manager": {
          "data": {
            "type": "people",
            "id": "9069"
          }
        },
        "last_actor": {
          "data": {
            "type": "people",
            "id": "9068"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2321"
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "template_object": {
          "data": null
        }
      }
    },
    {
      "id": "9068",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8951@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": 9029,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-12-06T01:22:22.108+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": "2440"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": null
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9371"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "6710",
      "type": "companies",
      "attributes": {
        "name": "Client4347",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-12-06T01:22:22.145+01:00",
        "last_activity_at": "2025-12-06T01:22:22.145+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "CLIE4351",
        "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": "2440"
          }
        },
        "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": "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": 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-12-06T01:22:00.000+01:00",
        "is_user": true,
        "user_id": 9030,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-12-06T01:22:22.132+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-12-06T01:22:22.132+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": "2440"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6709"
          }
        },
        "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": "2321",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2440"
          }
        },
        "workflow_statuses": {
          "data": [
            {
              "type": "workflow_statuses",
              "id": "2891"
            }
          ]
        }
      }
    },
    {
      "id": "9371",
      "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,
        "resolved_permissions": {
          "allocations_view": false,
          "automations_manage": true,
          "bank_accounts_manage": true,
          "billables_view": true,
          "budgets_view_restricted": true,
          "budgets_view_all": true,
          "budgets_manage": true,
          "budgets_share": true,
          "budgets_scenarios_view": true,
          "budgets_scenarios_manage": true,
          "budgets_scenarios_apply": true,
          "companies_view": true,
          "companies_manage": true,
          "contacts_view": true,
          "contacts_manage": true,
          "team_members_contact_info_view": true,
          "cost_rates_view": true,
          "cost_rates_view_inside_subsidiary": true,
          "cost_rates_manage": true,
          "cost_rates_view_for_subordinates": true,
          "custom_fields_manage": true,
          "task_custom_fields_manage": true,
          "doc_custom_fields_manage": true,
          "deals_view_restricted": true,
          "deals_view_all": true,
          "deals_manage": true,
          "deals_share": true,
          "deals_scenarios_view": true,
          "deals_scenarios_manage": true,
          "deals_scenarios_apply": true,
          "deals_proposals_delete_signed": true,
          "document_types_and_styles_manage": true,
          "docs_manage": true,
          "docs_view": true,
          "emails_manage": true,
          "entitlements_view_self": true,
          "entitlements_view_all": true,
          "entitlements_manage": true,
          "entitlements_view_inside_subsidiary": true,
          "events_view": true,
          "events_manage": true,
          "expenses_view_self": true,
          "expenses_view_all": true,
          "expenses_view_restricted": true,
          "expenses_manage_self": true,
          "expenses_manage": true,
          "expenses_approve_where_deal_owner": true,
          "expenses_approve_restricted": true,
          "expenses_approve_all": true,
          "financials_locking_manage": true,
          "financial_item_reports_view": true,
          "holidays_manage": true,
          "imports_manage": true,
          "integrations_manage_organizational": true,
          "integrations_manage_personal": true,
          "integrations_manage_task_management": true,
          "integrations_view_task_management": true,
          "invoices_view_restricted": true,
          "invoices_view_all": true,
          "invoices_manage_draft": true,
          "invoices_manage_finalized": true,
          "invoices_limited_manage_finalized": true,
          "invoices_copy_to_accounting": true,
          "invoices_manage_intercompany": true,
          "invoices_send_to_client": true,
          "organization_administrate": true,
          "organization_polaris_access": true,
          "overheads_manage": true,
          "payments_view": true,
          "payments_manage": true,
          "payment_reminders_manage": true,
          "payment_reminder_sequences_manage": true,
          "placeholders_view": true,
          "placeholders_manage": true,
          "profitability_view": true,
          "projects_view_restricted": true,
          "projects_view_all": true,
          "projects_manage": true,
          "boards_manage": true,
          "task_lists_manage": true,
          "purchase_orders_view_restricted": true,
          "purchase_orders_manage": true,
          "resource_requests_view": true,
          "resource_requests_create": true,
          "resource_requests_resolve": true,
          "rate_cards_view": true,
          "rate_cards_manage": true,
          "report_categories_manage": true,
          "insights_view": true,
          "insights_manage": true,
          "roles_view": true,
          "roles_manage": true,
          "sales_manage": true,
          "service_bookings_view_self": true,
          "service_bookings_view_restricted": true,
          "service_bookings_view_all": true,
          "service_bookings_manage": true,
          "service_bookings_view_tentative": true,
          "service_types_view": true,
          "service_types_manage": true,
          "subscription_manage_billing": true,
          "subscription_manage_seats": true,
          "subscription_manage": true,
          "surveys_manage": true,
          "tasks_view": true,
          "tasks_manage": true,
          "tax_rates_manage": true,
          "teams_view": true,
          "teams_manage": true,
          "time_entries_view_all": true,
          "time_entries_view_restricted": true,
          "time_entries_manage": true,
          "time_entries_manage_self": true,
          "time_entries_manage_locked": true,
          "time_entries_approve_restricted": true,
          "time_entries_approve_where_user_is_approver": true,
          "time_entries_approve_all": true,
          "time_off_bookings_view_all": true,
          "time_off_bookings_manage_self": true,
          "time_off_bookings_manage_all": true,
          "time_off_bookings_approve_all": true,
          "time_off_bookings_approve_restricted": true,
          "time_off_bookings_view_note": true,
          "time_off_bookings_view_inside_subsidiary": true,
          "time_reports_view_self": true,
          "time_reports_view_all": true,
          "time_tracking_policies_manage": true,
          "team_members_and_roles_view": true,
          "team_members_manage": true,
          "team_members_roles_manage": true,
          "clients_view": true,
          "clients_manage": true,
          "contacts_custom_field_values_view": true,
          "contacts_custom_field_values_manage": true,
          "contacts_sensitive_custom_field_values_view": true,
          "contacts_sensitive_custom_field_values_manage": true,
          "employees_field_values_view": true,
          "employees_field_values_manage": true,
          "employees_sensitive_custom_field_values_view": true,
          "employees_sensitive_custom_field_values_manage": true,
          "clients_deactivation_and_offboarding_manage": true,
          "team_members_deactivation_and_offboarding_manage": true,
          "webhooks_manage_webhooks": true,
          "webhooks_manage_own_zapier_triggers": true,
          "workflows_manage": true,
          "workload_items_view": true
        }
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2440"
          }
        }
      }
    },
    {
      "id": "6709",
      "type": "companies",
      "attributes": {
        "name": "Organization2441",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-12-06T01:22:22.118+01:00",
        "last_activity_at": "2025-12-06T01:22:22.118+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": "2440"
          }
        },
        "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": "9372",
      "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,
        "resolved_permissions": {
          "allocations_view": false,
          "automations_manage": false,
          "bank_accounts_manage": false,
          "billables_view": false,
          "budgets_view_restricted": false,
          "budgets_view_all": false,
          "budgets_manage": false,
          "budgets_share": false,
          "budgets_scenarios_view": false,
          "budgets_scenarios_manage": false,
          "budgets_scenarios_apply": false,
          "companies_view": false,
          "companies_manage": false,
          "contacts_view": false,
          "contacts_manage": false,
          "team_members_contact_info_view": true,
          "cost_rates_view": false,
          "cost_rates_view_inside_subsidiary": false,
          "cost_rates_manage": false,
          "cost_rates_view_for_subordinates": false,
          "custom_fields_manage": false,
          "task_custom_fields_manage": false,
          "doc_custom_fields_manage": false,
          "deals_view_restricted": false,
          "deals_view_all": false,
          "deals_manage": false,
          "deals_share": false,
          "deals_scenarios_view": false,
          "deals_scenarios_manage": false,
          "deals_scenarios_apply": false,
          "deals_proposals_delete_signed": false,
          "document_types_and_styles_manage": false,
          "docs_manage": true,
          "docs_view": true,
          "emails_manage": false,
          "entitlements_view_self": true,
          "entitlements_view_all": false,
          "entitlements_manage": false,
          "entitlements_view_inside_subsidiary": false,
          "events_view": true,
          "events_manage": false,
          "expenses_view_self": true,
          "expenses_view_all": false,
          "expenses_view_restricted": false,
          "expenses_manage_self": true,
          "expenses_manage": false,
          "expenses_approve_where_deal_owner": false,
          "expenses_approve_restricted": false,
          "expenses_approve_all": false,
          "financials_locking_manage": false,
          "financial_item_reports_view": false,
          "holidays_manage": false,
          "imports_manage": false,
          "integrations_manage_organizational": false,
          "integrations_manage_personal": true,
          "integrations_manage_task_management": false,
          "integrations_view_task_management": true,
          "invoices_view_restricted": false,
          "invoices_view_all": false,
          "invoices_manage_draft": false,
          "invoices_manage_finalized": false,
          "invoices_limited_manage_finalized": false,
          "invoices_copy_to_accounting": false,
          "invoices_manage_intercompany": false,
          "invoices_send_to_client": false,
          "organization_administrate": false,
          "organization_polaris_access": false,
          "overheads_manage": false,
          "payments_view": false,
          "payments_manage": false,
          "payment_reminders_manage": false,
          "payment_reminder_sequences_manage": false,
          "placeholders_view": false,
          "placeholders_manage": false,
          "profitability_view": false,
          "projects_view_restricted": true,
          "projects_view_all": false,
          "projects_manage": false,
          "boards_manage": false,
          "task_lists_manage": true,
          "purchase_orders_view_restricted": false,
          "purchase_orders_manage": false,
          "resource_requests_view": false,
          "resource_requests_create": false,
          "resource_requests_resolve": false,
          "rate_cards_view": false,
          "rate_cards_manage": false,
          "report_categories_manage": false,
          "insights_view": false,
          "insights_manage": false,
          "roles_view": false,
          "roles_manage": false,
          "sales_manage": false,
          "service_bookings_view_self": true,
          "service_bookings_view_restricted": false,
          "service_bookings_view_all": false,
          "service_bookings_manage": false,
          "service_bookings_view_tentative": false,
          "service_types_view": true,
          "service_types_manage": false,
          "subscription_manage_billing": false,
          "subscription_manage_seats": false,
          "subscription_manage": false,
          "surveys_manage": false,
          "tasks_view": true,
          "tasks_manage": true,
          "tax_rates_manage": false,
          "teams_view": true,
          "teams_manage": false,
          "time_entries_view_all": false,
          "time_entries_view_restricted": false,
          "time_entries_manage": false,
          "time_entries_manage_self": true,
          "time_entries_manage_locked": false,
          "time_entries_approve_restricted": false,
          "time_entries_approve_where_user_is_approver": false,
          "time_entries_approve_all": false,
          "time_off_bookings_view_all": false,
          "time_off_bookings_manage_self": true,
          "time_off_bookings_manage_all": false,
          "time_off_bookings_approve_all": false,
          "time_off_bookings_approve_restricted": false,
          "time_off_bookings_view_note": false,
          "time_off_bookings_view_inside_subsidiary": false,
          "time_reports_view_self": true,
          "time_reports_view_all": false,
          "time_tracking_policies_manage": false,
          "team_members_and_roles_view": false,
          "team_members_manage": false,
          "team_members_roles_manage": false,
          "clients_view": false,
          "clients_manage": false,
          "contacts_custom_field_values_view": false,
          "contacts_custom_field_values_manage": false,
          "contacts_sensitive_custom_field_values_view": false,
          "contacts_sensitive_custom_field_values_manage": false,
          "employees_field_values_view": true,
          "employees_field_values_manage": false,
          "employees_sensitive_custom_field_values_view": false,
          "employees_sensitive_custom_field_values_manage": false,
          "clients_deactivation_and_offboarding_manage": false,
          "team_members_deactivation_and_offboarding_manage": false,
          "webhooks_manage_webhooks": false,
          "webhooks_manage_own_zapier_triggers": false,
          "workflows_manage": false,
          "workload_items_view": true
        }
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2440"
          }
        }
      }
    },
    {
      "id": "2891",
      "type": "workflow_statuses",
      "attributes": {
        "name": "Closed",
        "color_id": "1",
        "position": 1,
        "category_id": 3
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2440"
          }
        },
        "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-12-06T01:22:22.351+01:00",
      "updated_at": "2025-12-06T01:22:22.351+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": "2441"
        }
      },
      "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-12-06T01:22:22.345+01:00",
        "updated_at": "2025-12-06T01:22:22.352+01:00"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2441"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "1863"
          }
        },
        "creator": {
          "data": {
            "type": "people",
            "id": "9070"
          }
        },
        "updater": {
          "data": {
            "type": "people",
            "id": "9070"
          }
        }
      }
    },
    {
      "id": "1863",
      "type": "projects",
      "attributes": {
        "name": "test project",
        "number": "1",
        "preferences": {},
        "project_number": "1",
        "project_type_id": 2,
        "project_color_id": null,
        "last_activity_at": "2025-12-06T01:22:22.000+01:00",
        "tag_colors": {},
        "archived_at": null,
        "created_at": "2025-12-06T01:22:22.334+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": "2441"
          }
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6712"
          }
        },
        "project_manager": {
          "data": {
            "type": "people",
            "id": "9071"
          }
        },
        "last_actor": {
          "data": {
            "type": "people",
            "id": "9070"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2322"
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "template_object": {
          "data": null
        }
      }
    },
    {
      "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": 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": 9031,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-12-06T01:22:22.297+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": "2441"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": null
        },
        "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": "6712",
      "type": "companies",
      "attributes": {
        "name": "Client4348",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-12-06T01:22:22.330+01:00",
        "last_activity_at": "2025-12-06T01:22:22.330+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "CLIE4352",
        "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": "2441"
          }
        },
        "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": "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": 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-12-06T01:22:00.000+01:00",
        "is_user": true,
        "user_id": 9032,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-12-06T01:22:22.318+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-12-06T01:22:22.318+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": "2441"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6711"
          }
        },
        "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": "2322",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2441"
          }
        },
        "workflow_statuses": {
          "data": [
            {
              "type": "workflow_statuses",
              "id": "2892"
            }
          ]
        }
      }
    },
    {
      "id": "9373",
      "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,
        "resolved_permissions": {
          "allocations_view": false,
          "automations_manage": true,
          "bank_accounts_manage": true,
          "billables_view": true,
          "budgets_view_restricted": true,
          "budgets_view_all": true,
          "budgets_manage": true,
          "budgets_share": true,
          "budgets_scenarios_view": true,
          "budgets_scenarios_manage": true,
          "budgets_scenarios_apply": true,
          "companies_view": true,
          "companies_manage": true,
          "contacts_view": true,
          "contacts_manage": true,
          "team_members_contact_info_view": true,
          "cost_rates_view": true,
          "cost_rates_view_inside_subsidiary": true,
          "cost_rates_manage": true,
          "cost_rates_view_for_subordinates": true,
          "custom_fields_manage": true,
          "task_custom_fields_manage": true,
          "doc_custom_fields_manage": true,
          "deals_view_restricted": true,
          "deals_view_all": true,
          "deals_manage": true,
          "deals_share": true,
          "deals_scenarios_view": true,
          "deals_scenarios_manage": true,
          "deals_scenarios_apply": true,
          "deals_proposals_delete_signed": true,
          "document_types_and_styles_manage": true,
          "docs_manage": true,
          "docs_view": true,
          "emails_manage": true,
          "entitlements_view_self": true,
          "entitlements_view_all": true,
          "entitlements_manage": true,
          "entitlements_view_inside_subsidiary": true,
          "events_view": true,
          "events_manage": true,
          "expenses_view_self": true,
          "expenses_view_all": true,
          "expenses_view_restricted": true,
          "expenses_manage_self": true,
          "expenses_manage": true,
          "expenses_approve_where_deal_owner": true,
          "expenses_approve_restricted": true,
          "expenses_approve_all": true,
          "financials_locking_manage": true,
          "financial_item_reports_view": true,
          "holidays_manage": true,
          "imports_manage": true,
          "integrations_manage_organizational": true,
          "integrations_manage_personal": true,
          "integrations_manage_task_management": true,
          "integrations_view_task_management": true,
          "invoices_view_restricted": true,
          "invoices_view_all": true,
          "invoices_manage_draft": true,
          "invoices_manage_finalized": true,
          "invoices_limited_manage_finalized": true,
          "invoices_copy_to_accounting": true,
          "invoices_manage_intercompany": true,
          "invoices_send_to_client": true,
          "organization_administrate": true,
          "organization_polaris_access": true,
          "overheads_manage": true,
          "payments_view": true,
          "payments_manage": true,
          "payment_reminders_manage": true,
          "payment_reminder_sequences_manage": true,
          "placeholders_view": true,
          "placeholders_manage": true,
          "profitability_view": true,
          "projects_view_restricted": true,
          "projects_view_all": true,
          "projects_manage": true,
          "boards_manage": true,
          "task_lists_manage": true,
          "purchase_orders_view_restricted": true,
          "purchase_orders_manage": true,
          "resource_requests_view": true,
          "resource_requests_create": true,
          "resource_requests_resolve": true,
          "rate_cards_view": true,
          "rate_cards_manage": true,
          "report_categories_manage": true,
          "insights_view": true,
          "insights_manage": true,
          "roles_view": true,
          "roles_manage": true,
          "sales_manage": true,
          "service_bookings_view_self": true,
          "service_bookings_view_restricted": true,
          "service_bookings_view_all": true,
          "service_bookings_manage": true,
          "service_bookings_view_tentative": true,
          "service_types_view": true,
          "service_types_manage": true,
          "subscription_manage_billing": true,
          "subscription_manage_seats": true,
          "subscription_manage": true,
          "surveys_manage": true,
          "tasks_view": true,
          "tasks_manage": true,
          "tax_rates_manage": true,
          "teams_view": true,
          "teams_manage": true,
          "time_entries_view_all": true,
          "time_entries_view_restricted": true,
          "time_entries_manage": true,
          "time_entries_manage_self": true,
          "time_entries_manage_locked": true,
          "time_entries_approve_restricted": true,
          "time_entries_approve_where_user_is_approver": true,
          "time_entries_approve_all": true,
          "time_off_bookings_view_all": true,
          "time_off_bookings_manage_self": true,
          "time_off_bookings_manage_all": true,
          "time_off_bookings_approve_all": true,
          "time_off_bookings_approve_restricted": true,
          "time_off_bookings_view_note": true,
          "time_off_bookings_view_inside_subsidiary": true,
          "time_reports_view_self": true,
          "time_reports_view_all": true,
          "time_tracking_policies_manage": true,
          "team_members_and_roles_view": true,
          "team_members_manage": true,
          "team_members_roles_manage": true,
          "clients_view": true,
          "clients_manage": true,
          "contacts_custom_field_values_view": true,
          "contacts_custom_field_values_manage": true,
          "contacts_sensitive_custom_field_values_view": true,
          "contacts_sensitive_custom_field_values_manage": true,
          "employees_field_values_view": true,
          "employees_field_values_manage": true,
          "employees_sensitive_custom_field_values_view": true,
          "employees_sensitive_custom_field_values_manage": true,
          "clients_deactivation_and_offboarding_manage": true,
          "team_members_deactivation_and_offboarding_manage": true,
          "webhooks_manage_webhooks": true,
          "webhooks_manage_own_zapier_triggers": true,
          "workflows_manage": true,
          "workload_items_view": true
        }
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2441"
          }
        }
      }
    },
    {
      "id": "6711",
      "type": "companies",
      "attributes": {
        "name": "Organization2442",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-12-06T01:22:22.305+01:00",
        "last_activity_at": "2025-12-06T01:22:22.305+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": "2441"
          }
        },
        "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": "9374",
      "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,
        "resolved_permissions": {
          "allocations_view": false,
          "automations_manage": false,
          "bank_accounts_manage": false,
          "billables_view": false,
          "budgets_view_restricted": false,
          "budgets_view_all": false,
          "budgets_manage": false,
          "budgets_share": false,
          "budgets_scenarios_view": false,
          "budgets_scenarios_manage": false,
          "budgets_scenarios_apply": false,
          "companies_view": false,
          "companies_manage": false,
          "contacts_view": false,
          "contacts_manage": false,
          "team_members_contact_info_view": true,
          "cost_rates_view": false,
          "cost_rates_view_inside_subsidiary": false,
          "cost_rates_manage": false,
          "cost_rates_view_for_subordinates": false,
          "custom_fields_manage": false,
          "task_custom_fields_manage": false,
          "doc_custom_fields_manage": false,
          "deals_view_restricted": false,
          "deals_view_all": false,
          "deals_manage": false,
          "deals_share": false,
          "deals_scenarios_view": false,
          "deals_scenarios_manage": false,
          "deals_scenarios_apply": false,
          "deals_proposals_delete_signed": false,
          "document_types_and_styles_manage": false,
          "docs_manage": true,
          "docs_view": true,
          "emails_manage": false,
          "entitlements_view_self": true,
          "entitlements_view_all": false,
          "entitlements_manage": false,
          "entitlements_view_inside_subsidiary": false,
          "events_view": true,
          "events_manage": false,
          "expenses_view_self": true,
          "expenses_view_all": false,
          "expenses_view_restricted": false,
          "expenses_manage_self": true,
          "expenses_manage": false,
          "expenses_approve_where_deal_owner": false,
          "expenses_approve_restricted": false,
          "expenses_approve_all": false,
          "financials_locking_manage": false,
          "financial_item_reports_view": false,
          "holidays_manage": false,
          "imports_manage": false,
          "integrations_manage_organizational": false,
          "integrations_manage_personal": true,
          "integrations_manage_task_management": false,
          "integrations_view_task_management": true,
          "invoices_view_restricted": false,
          "invoices_view_all": false,
          "invoices_manage_draft": false,
          "invoices_manage_finalized": false,
          "invoices_limited_manage_finalized": false,
          "invoices_copy_to_accounting": false,
          "invoices_manage_intercompany": false,
          "invoices_send_to_client": false,
          "organization_administrate": false,
          "organization_polaris_access": false,
          "overheads_manage": false,
          "payments_view": false,
          "payments_manage": false,
          "payment_reminders_manage": false,
          "payment_reminder_sequences_manage": false,
          "placeholders_view": false,
          "placeholders_manage": false,
          "profitability_view": false,
          "projects_view_restricted": true,
          "projects_view_all": false,
          "projects_manage": false,
          "boards_manage": false,
          "task_lists_manage": true,
          "purchase_orders_view_restricted": false,
          "purchase_orders_manage": false,
          "resource_requests_view": false,
          "resource_requests_create": false,
          "resource_requests_resolve": false,
          "rate_cards_view": false,
          "rate_cards_manage": false,
          "report_categories_manage": false,
          "insights_view": false,
          "insights_manage": false,
          "roles_view": false,
          "roles_manage": false,
          "sales_manage": false,
          "service_bookings_view_self": true,
          "service_bookings_view_restricted": false,
          "service_bookings_view_all": false,
          "service_bookings_manage": false,
          "service_bookings_view_tentative": false,
          "service_types_view": true,
          "service_types_manage": false,
          "subscription_manage_billing": false,
          "subscription_manage_seats": false,
          "subscription_manage": false,
          "surveys_manage": false,
          "tasks_view": true,
          "tasks_manage": true,
          "tax_rates_manage": false,
          "teams_view": true,
          "teams_manage": false,
          "time_entries_view_all": false,
          "time_entries_view_restricted": false,
          "time_entries_manage": false,
          "time_entries_manage_self": true,
          "time_entries_manage_locked": false,
          "time_entries_approve_restricted": false,
          "time_entries_approve_where_user_is_approver": false,
          "time_entries_approve_all": false,
          "time_off_bookings_view_all": false,
          "time_off_bookings_manage_self": true,
          "time_off_bookings_manage_all": false,
          "time_off_bookings_approve_all": false,
          "time_off_bookings_approve_restricted": false,
          "time_off_bookings_view_note": false,
          "time_off_bookings_view_inside_subsidiary": false,
          "time_reports_view_self": true,
          "time_reports_view_all": false,
          "time_tracking_policies_manage": false,
          "team_members_and_roles_view": false,
          "team_members_manage": false,
          "team_members_roles_manage": false,
          "clients_view": false,
          "clients_manage": false,
          "contacts_custom_field_values_view": false,
          "contacts_custom_field_values_manage": false,
          "contacts_sensitive_custom_field_values_view": false,
          "contacts_sensitive_custom_field_values_manage": false,
          "employees_field_values_view": true,
          "employees_field_values_manage": false,
          "employees_sensitive_custom_field_values_view": false,
          "employees_sensitive_custom_field_values_manage": false,
          "clients_deactivation_and_offboarding_manage": false,
          "team_members_deactivation_and_offboarding_manage": false,
          "webhooks_manage_webhooks": false,
          "webhooks_manage_own_zapier_triggers": false,
          "workflows_manage": false,
          "workload_items_view": true
        }
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2441"
          }
        }
      }
    },
    {
      "id": "2892",
      "type": "workflow_statuses",
      "attributes": {
        "name": "Closed",
        "color_id": "1",
        "position": 1,
        "category_id": 3
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2441"
          }
        },
        "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-12-06T01:22:22.509+01:00",
      "updated_at": "2025-12-06T01:22:22.509+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": "2442"
        }
      },
      "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-12-06T01:22:22.491+01:00",
        "updated_at": "2025-12-06T01:22:22.511+01:00"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2442"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "1864"
          }
        },
        "creator": {
          "data": {
            "type": "people",
            "id": "9072"
          }
        },
        "updater": {
          "data": {
            "type": "people",
            "id": "9072"
          }
        }
      }
    },
    {
      "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-12-06T01:22:22.000+01:00",
        "tag_colors": {},
        "archived_at": null,
        "created_at": "2025-12-06T01:22:22.480+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": "2442"
          }
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6714"
          }
        },
        "project_manager": {
          "data": {
            "type": "people",
            "id": "9073"
          }
        },
        "last_actor": {
          "data": {
            "type": "people",
            "id": "9072"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2323"
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "template_object": {
          "data": null
        }
      }
    },
    {
      "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": 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": 9033,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-12-06T01:22:22.445+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": "2442"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": null
        },
        "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": "6714",
      "type": "companies",
      "attributes": {
        "name": "Client4349",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-12-06T01:22:22.476+01:00",
        "last_activity_at": "2025-12-06T01:22:22.476+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "CLIE4353",
        "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": "2442"
          }
        },
        "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": "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": 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-12-06T01:22:00.000+01:00",
        "is_user": true,
        "user_id": 9034,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-12-06T01:22:22.465+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-12-06T01:22:22.465+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": "2442"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6713"
          }
        },
        "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": "2323",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2442"
          }
        },
        "workflow_statuses": {
          "data": [
            {
              "type": "workflow_statuses",
              "id": "2893"
            }
          ]
        }
      }
    },
    {
      "id": "9375",
      "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,
        "resolved_permissions": {
          "allocations_view": false,
          "automations_manage": true,
          "bank_accounts_manage": true,
          "billables_view": true,
          "budgets_view_restricted": true,
          "budgets_view_all": true,
          "budgets_manage": true,
          "budgets_share": true,
          "budgets_scenarios_view": true,
          "budgets_scenarios_manage": true,
          "budgets_scenarios_apply": true,
          "companies_view": true,
          "companies_manage": true,
          "contacts_view": true,
          "contacts_manage": true,
          "team_members_contact_info_view": true,
          "cost_rates_view": true,
          "cost_rates_view_inside_subsidiary": true,
          "cost_rates_manage": true,
          "cost_rates_view_for_subordinates": true,
          "custom_fields_manage": true,
          "task_custom_fields_manage": true,
          "doc_custom_fields_manage": true,
          "deals_view_restricted": true,
          "deals_view_all": true,
          "deals_manage": true,
          "deals_share": true,
          "deals_scenarios_view": true,
          "deals_scenarios_manage": true,
          "deals_scenarios_apply": true,
          "deals_proposals_delete_signed": true,
          "document_types_and_styles_manage": true,
          "docs_manage": true,
          "docs_view": true,
          "emails_manage": true,
          "entitlements_view_self": true,
          "entitlements_view_all": true,
          "entitlements_manage": true,
          "entitlements_view_inside_subsidiary": true,
          "events_view": true,
          "events_manage": true,
          "expenses_view_self": true,
          "expenses_view_all": true,
          "expenses_view_restricted": true,
          "expenses_manage_self": true,
          "expenses_manage": true,
          "expenses_approve_where_deal_owner": true,
          "expenses_approve_restricted": true,
          "expenses_approve_all": true,
          "financials_locking_manage": true,
          "financial_item_reports_view": true,
          "holidays_manage": true,
          "imports_manage": true,
          "integrations_manage_organizational": true,
          "integrations_manage_personal": true,
          "integrations_manage_task_management": true,
          "integrations_view_task_management": true,
          "invoices_view_restricted": true,
          "invoices_view_all": true,
          "invoices_manage_draft": true,
          "invoices_manage_finalized": true,
          "invoices_limited_manage_finalized": true,
          "invoices_copy_to_accounting": true,
          "invoices_manage_intercompany": true,
          "invoices_send_to_client": true,
          "organization_administrate": true,
          "organization_polaris_access": true,
          "overheads_manage": true,
          "payments_view": true,
          "payments_manage": true,
          "payment_reminders_manage": true,
          "payment_reminder_sequences_manage": true,
          "placeholders_view": true,
          "placeholders_manage": true,
          "profitability_view": true,
          "projects_view_restricted": true,
          "projects_view_all": true,
          "projects_manage": true,
          "boards_manage": true,
          "task_lists_manage": true,
          "purchase_orders_view_restricted": true,
          "purchase_orders_manage": true,
          "resource_requests_view": true,
          "resource_requests_create": true,
          "resource_requests_resolve": true,
          "rate_cards_view": true,
          "rate_cards_manage": true,
          "report_categories_manage": true,
          "insights_view": true,
          "insights_manage": true,
          "roles_view": true,
          "roles_manage": true,
          "sales_manage": true,
          "service_bookings_view_self": true,
          "service_bookings_view_restricted": true,
          "service_bookings_view_all": true,
          "service_bookings_manage": true,
          "service_bookings_view_tentative": true,
          "service_types_view": true,
          "service_types_manage": true,
          "subscription_manage_billing": true,
          "subscription_manage_seats": true,
          "subscription_manage": true,
          "surveys_manage": true,
          "tasks_view": true,
          "tasks_manage": true,
          "tax_rates_manage": true,
          "teams_view": true,
          "teams_manage": true,
          "time_entries_view_all": true,
          "time_entries_view_restricted": true,
          "time_entries_manage": true,
          "time_entries_manage_self": true,
          "time_entries_manage_locked": true,
          "time_entries_approve_restricted": true,
          "time_entries_approve_where_user_is_approver": true,
          "time_entries_approve_all": true,
          "time_off_bookings_view_all": true,
          "time_off_bookings_manage_self": true,
          "time_off_bookings_manage_all": true,
          "time_off_bookings_approve_all": true,
          "time_off_bookings_approve_restricted": true,
          "time_off_bookings_view_note": true,
          "time_off_bookings_view_inside_subsidiary": true,
          "time_reports_view_self": true,
          "time_reports_view_all": true,
          "time_tracking_policies_manage": true,
          "team_members_and_roles_view": true,
          "team_members_manage": true,
          "team_members_roles_manage": true,
          "clients_view": true,
          "clients_manage": true,
          "contacts_custom_field_values_view": true,
          "contacts_custom_field_values_manage": true,
          "contacts_sensitive_custom_field_values_view": true,
          "contacts_sensitive_custom_field_values_manage": true,
          "employees_field_values_view": true,
          "employees_field_values_manage": true,
          "employees_sensitive_custom_field_values_view": true,
          "employees_sensitive_custom_field_values_manage": true,
          "clients_deactivation_and_offboarding_manage": true,
          "team_members_deactivation_and_offboarding_manage": true,
          "webhooks_manage_webhooks": true,
          "webhooks_manage_own_zapier_triggers": true,
          "workflows_manage": true,
          "workload_items_view": true
        }
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2442"
          }
        }
      }
    },
    {
      "id": "6713",
      "type": "companies",
      "attributes": {
        "name": "Organization2443",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-12-06T01:22:22.453+01:00",
        "last_activity_at": "2025-12-06T01:22:22.453+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": "2442"
          }
        },
        "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": "9376",
      "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,
        "resolved_permissions": {
          "allocations_view": false,
          "automations_manage": false,
          "bank_accounts_manage": false,
          "billables_view": false,
          "budgets_view_restricted": false,
          "budgets_view_all": false,
          "budgets_manage": false,
          "budgets_share": false,
          "budgets_scenarios_view": false,
          "budgets_scenarios_manage": false,
          "budgets_scenarios_apply": false,
          "companies_view": false,
          "companies_manage": false,
          "contacts_view": false,
          "contacts_manage": false,
          "team_members_contact_info_view": true,
          "cost_rates_view": false,
          "cost_rates_view_inside_subsidiary": false,
          "cost_rates_manage": false,
          "cost_rates_view_for_subordinates": false,
          "custom_fields_manage": false,
          "task_custom_fields_manage": false,
          "doc_custom_fields_manage": false,
          "deals_view_restricted": false,
          "deals_view_all": false,
          "deals_manage": false,
          "deals_share": false,
          "deals_scenarios_view": false,
          "deals_scenarios_manage": false,
          "deals_scenarios_apply": false,
          "deals_proposals_delete_signed": false,
          "document_types_and_styles_manage": false,
          "docs_manage": true,
          "docs_view": true,
          "emails_manage": false,
          "entitlements_view_self": true,
          "entitlements_view_all": false,
          "entitlements_manage": false,
          "entitlements_view_inside_subsidiary": false,
          "events_view": true,
          "events_manage": false,
          "expenses_view_self": true,
          "expenses_view_all": false,
          "expenses_view_restricted": false,
          "expenses_manage_self": true,
          "expenses_manage": false,
          "expenses_approve_where_deal_owner": false,
          "expenses_approve_restricted": false,
          "expenses_approve_all": false,
          "financials_locking_manage": false,
          "financial_item_reports_view": false,
          "holidays_manage": false,
          "imports_manage": false,
          "integrations_manage_organizational": false,
          "integrations_manage_personal": true,
          "integrations_manage_task_management": false,
          "integrations_view_task_management": true,
          "invoices_view_restricted": false,
          "invoices_view_all": false,
          "invoices_manage_draft": false,
          "invoices_manage_finalized": false,
          "invoices_limited_manage_finalized": false,
          "invoices_copy_to_accounting": false,
          "invoices_manage_intercompany": false,
          "invoices_send_to_client": false,
          "organization_administrate": false,
          "organization_polaris_access": false,
          "overheads_manage": false,
          "payments_view": false,
          "payments_manage": false,
          "payment_reminders_manage": false,
          "payment_reminder_sequences_manage": false,
          "placeholders_view": false,
          "placeholders_manage": false,
          "profitability_view": false,
          "projects_view_restricted": true,
          "projects_view_all": false,
          "projects_manage": false,
          "boards_manage": false,
          "task_lists_manage": true,
          "purchase_orders_view_restricted": false,
          "purchase_orders_manage": false,
          "resource_requests_view": false,
          "resource_requests_create": false,
          "resource_requests_resolve": false,
          "rate_cards_view": false,
          "rate_cards_manage": false,
          "report_categories_manage": false,
          "insights_view": false,
          "insights_manage": false,
          "roles_view": false,
          "roles_manage": false,
          "sales_manage": false,
          "service_bookings_view_self": true,
          "service_bookings_view_restricted": false,
          "service_bookings_view_all": false,
          "service_bookings_manage": false,
          "service_bookings_view_tentative": false,
          "service_types_view": true,
          "service_types_manage": false,
          "subscription_manage_billing": false,
          "subscription_manage_seats": false,
          "subscription_manage": false,
          "surveys_manage": false,
          "tasks_view": true,
          "tasks_manage": true,
          "tax_rates_manage": false,
          "teams_view": true,
          "teams_manage": false,
          "time_entries_view_all": false,
          "time_entries_view_restricted": false,
          "time_entries_manage": false,
          "time_entries_manage_self": true,
          "time_entries_manage_locked": false,
          "time_entries_approve_restricted": false,
          "time_entries_approve_where_user_is_approver": false,
          "time_entries_approve_all": false,
          "time_off_bookings_view_all": false,
          "time_off_bookings_manage_self": true,
          "time_off_bookings_manage_all": false,
          "time_off_bookings_approve_all": false,
          "time_off_bookings_approve_restricted": false,
          "time_off_bookings_view_note": false,
          "time_off_bookings_view_inside_subsidiary": false,
          "time_reports_view_self": true,
          "time_reports_view_all": false,
          "time_tracking_policies_manage": false,
          "team_members_and_roles_view": false,
          "team_members_manage": false,
          "team_members_roles_manage": false,
          "clients_view": false,
          "clients_manage": false,
          "contacts_custom_field_values_view": false,
          "contacts_custom_field_values_manage": false,
          "contacts_sensitive_custom_field_values_view": false,
          "contacts_sensitive_custom_field_values_manage": false,
          "employees_field_values_view": true,
          "employees_field_values_manage": false,
          "employees_sensitive_custom_field_values_view": false,
          "employees_sensitive_custom_field_values_manage": false,
          "clients_deactivation_and_offboarding_manage": false,
          "team_members_deactivation_and_offboarding_manage": false,
          "webhooks_manage_webhooks": false,
          "webhooks_manage_own_zapier_triggers": false,
          "workflows_manage": false,
          "workload_items_view": true
        }
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2442"
          }
        }
      }
    },
    {
      "id": "2893",
      "type": "workflow_statuses",
      "attributes": {
        "name": "Closed",
        "color_id": "1",
        "position": 1,
        "category_id": 3
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2442"
          }
        },
        "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-12-06T01:22:22.731+01:00",
      "updated_at": "2025-12-06T01:22:22.743+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": "2444"
        }
      },
      "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-12-06T01:22:22.725+01:00",
        "updated_at": "2025-12-06T01:22:22.745+01:00"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2444"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "1866"
          }
        },
        "creator": {
          "data": {
            "type": "people",
            "id": "9076"
          }
        },
        "updater": {
          "data": {
            "type": "people",
            "id": "9076"
          }
        }
      }
    },
    {
      "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-12-06T01:22:22.000+01:00",
        "tag_colors": {},
        "archived_at": null,
        "created_at": "2025-12-06T01:22:22.714+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": "2444"
          }
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6718"
          }
        },
        "project_manager": {
          "data": {
            "type": "people",
            "id": "9077"
          }
        },
        "last_actor": {
          "data": {
            "type": "people",
            "id": "9076"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2325"
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "template_object": {
          "data": null
        }
      }
    },
    {
      "id": "9076",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8959@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": 9037,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-12-06T01:22:22.679+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": "2444"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": null
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9379"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "6718",
      "type": "companies",
      "attributes": {
        "name": "Client4351",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-12-06T01:22:22.710+01:00",
        "last_activity_at": "2025-12-06T01:22:22.710+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "CLIE4355",
        "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": "2444"
          }
        },
        "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": "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": 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-12-06T01:22:00.000+01:00",
        "is_user": true,
        "user_id": 9038,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-12-06T01:22:22.699+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-12-06T01:22:22.699+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": "2444"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6717"
          }
        },
        "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": "2325",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2444"
          }
        },
        "workflow_statuses": {
          "data": [
            {
              "type": "workflow_statuses",
              "id": "2895"
            }
          ]
        }
      }
    },
    {
      "id": "9379",
      "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,
        "resolved_permissions": {
          "allocations_view": false,
          "automations_manage": true,
          "bank_accounts_manage": true,
          "billables_view": true,
          "budgets_view_restricted": true,
          "budgets_view_all": true,
          "budgets_manage": true,
          "budgets_share": true,
          "budgets_scenarios_view": true,
          "budgets_scenarios_manage": true,
          "budgets_scenarios_apply": true,
          "companies_view": true,
          "companies_manage": true,
          "contacts_view": true,
          "contacts_manage": true,
          "team_members_contact_info_view": true,
          "cost_rates_view": true,
          "cost_rates_view_inside_subsidiary": true,
          "cost_rates_manage": true,
          "cost_rates_view_for_subordinates": true,
          "custom_fields_manage": true,
          "task_custom_fields_manage": true,
          "doc_custom_fields_manage": true,
          "deals_view_restricted": true,
          "deals_view_all": true,
          "deals_manage": true,
          "deals_share": true,
          "deals_scenarios_view": true,
          "deals_scenarios_manage": true,
          "deals_scenarios_apply": true,
          "deals_proposals_delete_signed": true,
          "document_types_and_styles_manage": true,
          "docs_manage": true,
          "docs_view": true,
          "emails_manage": true,
          "entitlements_view_self": true,
          "entitlements_view_all": true,
          "entitlements_manage": true,
          "entitlements_view_inside_subsidiary": true,
          "events_view": true,
          "events_manage": true,
          "expenses_view_self": true,
          "expenses_view_all": true,
          "expenses_view_restricted": true,
          "expenses_manage_self": true,
          "expenses_manage": true,
          "expenses_approve_where_deal_owner": true,
          "expenses_approve_restricted": true,
          "expenses_approve_all": true,
          "financials_locking_manage": true,
          "financial_item_reports_view": true,
          "holidays_manage": true,
          "imports_manage": true,
          "integrations_manage_organizational": true,
          "integrations_manage_personal": true,
          "integrations_manage_task_management": true,
          "integrations_view_task_management": true,
          "invoices_view_restricted": true,
          "invoices_view_all": true,
          "invoices_manage_draft": true,
          "invoices_manage_finalized": true,
          "invoices_limited_manage_finalized": true,
          "invoices_copy_to_accounting": true,
          "invoices_manage_intercompany": true,
          "invoices_send_to_client": true,
          "organization_administrate": true,
          "organization_polaris_access": true,
          "overheads_manage": true,
          "payments_view": true,
          "payments_manage": true,
          "payment_reminders_manage": true,
          "payment_reminder_sequences_manage": true,
          "placeholders_view": true,
          "placeholders_manage": true,
          "profitability_view": true,
          "projects_view_restricted": true,
          "projects_view_all": true,
          "projects_manage": true,
          "boards_manage": true,
          "task_lists_manage": true,
          "purchase_orders_view_restricted": true,
          "purchase_orders_manage": true,
          "resource_requests_view": true,
          "resource_requests_create": true,
          "resource_requests_resolve": true,
          "rate_cards_view": true,
          "rate_cards_manage": true,
          "report_categories_manage": true,
          "insights_view": true,
          "insights_manage": true,
          "roles_view": true,
          "roles_manage": true,
          "sales_manage": true,
          "service_bookings_view_self": true,
          "service_bookings_view_restricted": true,
          "service_bookings_view_all": true,
          "service_bookings_manage": true,
          "service_bookings_view_tentative": true,
          "service_types_view": true,
          "service_types_manage": true,
          "subscription_manage_billing": true,
          "subscription_manage_seats": true,
          "subscription_manage": true,
          "surveys_manage": true,
          "tasks_view": true,
          "tasks_manage": true,
          "tax_rates_manage": true,
          "teams_view": true,
          "teams_manage": true,
          "time_entries_view_all": true,
          "time_entries_view_restricted": true,
          "time_entries_manage": true,
          "time_entries_manage_self": true,
          "time_entries_manage_locked": true,
          "time_entries_approve_restricted": true,
          "time_entries_approve_where_user_is_approver": true,
          "time_entries_approve_all": true,
          "time_off_bookings_view_all": true,
          "time_off_bookings_manage_self": true,
          "time_off_bookings_manage_all": true,
          "time_off_bookings_approve_all": true,
          "time_off_bookings_approve_restricted": true,
          "time_off_bookings_view_note": true,
          "time_off_bookings_view_inside_subsidiary": true,
          "time_reports_view_self": true,
          "time_reports_view_all": true,
          "time_tracking_policies_manage": true,
          "team_members_and_roles_view": true,
          "team_members_manage": true,
          "team_members_roles_manage": true,
          "clients_view": true,
          "clients_manage": true,
          "contacts_custom_field_values_view": true,
          "contacts_custom_field_values_manage": true,
          "contacts_sensitive_custom_field_values_view": true,
          "contacts_sensitive_custom_field_values_manage": true,
          "employees_field_values_view": true,
          "employees_field_values_manage": true,
          "employees_sensitive_custom_field_values_view": true,
          "employees_sensitive_custom_field_values_manage": true,
          "clients_deactivation_and_offboarding_manage": true,
          "team_members_deactivation_and_offboarding_manage": true,
          "webhooks_manage_webhooks": true,
          "webhooks_manage_own_zapier_triggers": true,
          "workflows_manage": true,
          "workload_items_view": true
        }
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2444"
          }
        }
      }
    },
    {
      "id": "6717",
      "type": "companies",
      "attributes": {
        "name": "Organization2445",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-12-06T01:22:22.687+01:00",
        "last_activity_at": "2025-12-06T01:22:22.687+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": "2444"
          }
        },
        "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": "9380",
      "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,
        "resolved_permissions": {
          "allocations_view": false,
          "automations_manage": false,
          "bank_accounts_manage": false,
          "billables_view": false,
          "budgets_view_restricted": false,
          "budgets_view_all": false,
          "budgets_manage": false,
          "budgets_share": false,
          "budgets_scenarios_view": false,
          "budgets_scenarios_manage": false,
          "budgets_scenarios_apply": false,
          "companies_view": false,
          "companies_manage": false,
          "contacts_view": false,
          "contacts_manage": false,
          "team_members_contact_info_view": true,
          "cost_rates_view": false,
          "cost_rates_view_inside_subsidiary": false,
          "cost_rates_manage": false,
          "cost_rates_view_for_subordinates": false,
          "custom_fields_manage": false,
          "task_custom_fields_manage": false,
          "doc_custom_fields_manage": false,
          "deals_view_restricted": false,
          "deals_view_all": false,
          "deals_manage": false,
          "deals_share": false,
          "deals_scenarios_view": false,
          "deals_scenarios_manage": false,
          "deals_scenarios_apply": false,
          "deals_proposals_delete_signed": false,
          "document_types_and_styles_manage": false,
          "docs_manage": true,
          "docs_view": true,
          "emails_manage": false,
          "entitlements_view_self": true,
          "entitlements_view_all": false,
          "entitlements_manage": false,
          "entitlements_view_inside_subsidiary": false,
          "events_view": true,
          "events_manage": false,
          "expenses_view_self": true,
          "expenses_view_all": false,
          "expenses_view_restricted": false,
          "expenses_manage_self": true,
          "expenses_manage": false,
          "expenses_approve_where_deal_owner": false,
          "expenses_approve_restricted": false,
          "expenses_approve_all": false,
          "financials_locking_manage": false,
          "financial_item_reports_view": false,
          "holidays_manage": false,
          "imports_manage": false,
          "integrations_manage_organizational": false,
          "integrations_manage_personal": true,
          "integrations_manage_task_management": false,
          "integrations_view_task_management": true,
          "invoices_view_restricted": false,
          "invoices_view_all": false,
          "invoices_manage_draft": false,
          "invoices_manage_finalized": false,
          "invoices_limited_manage_finalized": false,
          "invoices_copy_to_accounting": false,
          "invoices_manage_intercompany": false,
          "invoices_send_to_client": false,
          "organization_administrate": false,
          "organization_polaris_access": false,
          "overheads_manage": false,
          "payments_view": false,
          "payments_manage": false,
          "payment_reminders_manage": false,
          "payment_reminder_sequences_manage": false,
          "placeholders_view": false,
          "placeholders_manage": false,
          "profitability_view": false,
          "projects_view_restricted": true,
          "projects_view_all": false,
          "projects_manage": false,
          "boards_manage": false,
          "task_lists_manage": true,
          "purchase_orders_view_restricted": false,
          "purchase_orders_manage": false,
          "resource_requests_view": false,
          "resource_requests_create": false,
          "resource_requests_resolve": false,
          "rate_cards_view": false,
          "rate_cards_manage": false,
          "report_categories_manage": false,
          "insights_view": false,
          "insights_manage": false,
          "roles_view": false,
          "roles_manage": false,
          "sales_manage": false,
          "service_bookings_view_self": true,
          "service_bookings_view_restricted": false,
          "service_bookings_view_all": false,
          "service_bookings_manage": false,
          "service_bookings_view_tentative": false,
          "service_types_view": true,
          "service_types_manage": false,
          "subscription_manage_billing": false,
          "subscription_manage_seats": false,
          "subscription_manage": false,
          "surveys_manage": false,
          "tasks_view": true,
          "tasks_manage": true,
          "tax_rates_manage": false,
          "teams_view": true,
          "teams_manage": false,
          "time_entries_view_all": false,
          "time_entries_view_restricted": false,
          "time_entries_manage": false,
          "time_entries_manage_self": true,
          "time_entries_manage_locked": false,
          "time_entries_approve_restricted": false,
          "time_entries_approve_where_user_is_approver": false,
          "time_entries_approve_all": false,
          "time_off_bookings_view_all": false,
          "time_off_bookings_manage_self": true,
          "time_off_bookings_manage_all": false,
          "time_off_bookings_approve_all": false,
          "time_off_bookings_approve_restricted": false,
          "time_off_bookings_view_note": false,
          "time_off_bookings_view_inside_subsidiary": false,
          "time_reports_view_self": true,
          "time_reports_view_all": false,
          "time_tracking_policies_manage": false,
          "team_members_and_roles_view": false,
          "team_members_manage": false,
          "team_members_roles_manage": false,
          "clients_view": false,
          "clients_manage": false,
          "contacts_custom_field_values_view": false,
          "contacts_custom_field_values_manage": false,
          "contacts_sensitive_custom_field_values_view": false,
          "contacts_sensitive_custom_field_values_manage": false,
          "employees_field_values_view": true,
          "employees_field_values_manage": false,
          "employees_sensitive_custom_field_values_view": false,
          "employees_sensitive_custom_field_values_manage": false,
          "clients_deactivation_and_offboarding_manage": false,
          "team_members_deactivation_and_offboarding_manage": false,
          "webhooks_manage_webhooks": false,
          "webhooks_manage_own_zapier_triggers": false,
          "workflows_manage": false,
          "workload_items_view": true
        }
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2444"
          }
        }
      }
    },
    {
      "id": "2895",
      "type": "workflow_statuses",
      "attributes": {
        "name": "Closed",
        "color_id": "1",
        "position": 1,
        "category_id": 3
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2444"
          }
        },
        "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-12-06T01:22:22.977+01:00",
      "updated_at": "2025-12-06T01:22:23.001+01:00",
      "name": "Custom field no.36",
      "data_type_id": 3,
      "required": false,
      "description": null,
      "archived_at": "2025-12-06T01:22:23.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": "2446"
        }
      },
      "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-12-06T01:22:22.972+01:00",
        "updated_at": "2025-12-06T01:22:23.003+01:00"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2446"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "1868"
          }
        },
        "creator": {
          "data": {
            "type": "people",
            "id": "9080"
          }
        },
        "updater": {
          "data": {
            "type": "people",
            "id": "9080"
          }
        }
      }
    },
    {
      "id": "18",
      "type": "survey_field_options",
      "attributes": {
        "name": "High",
        "archived_at": "2025-12-06T01:22:23.000+01:00",
        "position": 1,
        "color_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2446"
          }
        },
        "survey_field": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "19",
      "type": "survey_field_options",
      "attributes": {
        "name": "High",
        "archived_at": "2025-12-06T01:22:23.000+01:00",
        "position": 1,
        "color_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2446"
          }
        },
        "survey_field": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "20",
      "type": "survey_field_options",
      "attributes": {
        "name": "High",
        "archived_at": "2025-12-06T01:22:23.000+01:00",
        "position": 1,
        "color_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2446"
          }
        },
        "survey_field": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "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-12-06T01:22:22.000+01:00",
        "tag_colors": {},
        "archived_at": null,
        "created_at": "2025-12-06T01:22:22.961+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": "2446"
          }
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6722"
          }
        },
        "project_manager": {
          "data": {
            "type": "people",
            "id": "9081"
          }
        },
        "last_actor": {
          "data": {
            "type": "people",
            "id": "9080"
          }
        },
        "workflow": {
          "data": {
            "type": "workflows",
            "id": "2327"
          }
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        },
        "template_object": {
          "data": null
        }
      }
    },
    {
      "id": "9080",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user8963@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": 9041,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-12-06T01:22:22.925+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": "2446"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": null
        },
        "subsidiary": {
          "data": null
        },
        "custom_role": {
          "data": {
            "type": "roles",
            "id": "9383"
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "data": []
        },
        "service_types": {
          "data": []
        },
        "custom_field_people": {
          "data": []
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "6722",
      "type": "companies",
      "attributes": {
        "name": "Client4353",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-12-06T01:22:22.957+01:00",
        "last_activity_at": "2025-12-06T01:22:22.957+01:00",
        "archived_at": null,
        "avatar_url": null,
        "invoice_email_recipients": {},
        "custom_fields": null,
        "company_code": "CLIE4357",
        "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": "2446"
          }
        },
        "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": "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": 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-12-06T01:22:00.000+01:00",
        "is_user": true,
        "user_id": 9042,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-12-06T01:22:22.945+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-12-06T01:22:22.945+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": "2446"
          }
        },
        "manager": {
          "data": null
        },
        "company": {
          "data": {
            "type": "companies",
            "id": "6721"
          }
        },
        "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": "2327",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2446"
          }
        },
        "workflow_statuses": {
          "data": [
            {
              "type": "workflow_statuses",
              "id": "2897"
            }
          ]
        }
      }
    },
    {
      "id": "9383",
      "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,
        "resolved_permissions": {
          "allocations_view": false,
          "automations_manage": true,
          "bank_accounts_manage": true,
          "billables_view": true,
          "budgets_view_restricted": true,
          "budgets_view_all": true,
          "budgets_manage": true,
          "budgets_share": true,
          "budgets_scenarios_view": true,
          "budgets_scenarios_manage": true,
          "budgets_scenarios_apply": true,
          "companies_view": true,
          "companies_manage": true,
          "contacts_view": true,
          "contacts_manage": true,
          "team_members_contact_info_view": true,
          "cost_rates_view": true,
          "cost_rates_view_inside_subsidiary": true,
          "cost_rates_manage": true,
          "cost_rates_view_for_subordinates": true,
          "custom_fields_manage": true,
          "task_custom_fields_manage": true,
          "doc_custom_fields_manage": true,
          "deals_view_restricted": true,
          "deals_view_all": true,
          "deals_manage": true,
          "deals_share": true,
          "deals_scenarios_view": true,
          "deals_scenarios_manage": true,
          "deals_scenarios_apply": true,
          "deals_proposals_delete_signed": true,
          "document_types_and_styles_manage": true,
          "docs_manage": true,
          "docs_view": true,
          "emails_manage": true,
          "entitlements_view_self": true,
          "entitlements_view_all": true,
          "entitlements_manage": true,
          "entitlements_view_inside_subsidiary": true,
          "events_view": true,
          "events_manage": true,
          "expenses_view_self": true,
          "expenses_view_all": true,
          "expenses_view_restricted": true,
          "expenses_manage_self": true,
          "expenses_manage": true,
          "expenses_approve_where_deal_owner": true,
          "expenses_approve_restricted": true,
          "expenses_approve_all": true,
          "financials_locking_manage": true,
          "financial_item_reports_view": true,
          "holidays_manage": true,
          "imports_manage": true,
          "integrations_manage_organizational": true,
          "integrations_manage_personal": true,
          "integrations_manage_task_management": true,
          "integrations_view_task_management": true,
          "invoices_view_restricted": true,
          "invoices_view_all": true,
          "invoices_manage_draft": true,
          "invoices_manage_finalized": true,
          "invoices_limited_manage_finalized": true,
          "invoices_copy_to_accounting": true,
          "invoices_manage_intercompany": true,
          "invoices_send_to_client": true,
          "organization_administrate": true,
          "organization_polaris_access": true,
          "overheads_manage": true,
          "payments_view": true,
          "payments_manage": true,
          "payment_reminders_manage": true,
          "payment_reminder_sequences_manage": true,
          "placeholders_view": true,
          "placeholders_manage": true,
          "profitability_view": true,
          "projects_view_restricted": true,
          "projects_view_all": true,
          "projects_manage": true,
          "boards_manage": true,
          "task_lists_manage": true,
          "purchase_orders_view_restricted": true,
          "purchase_orders_manage": true,
          "resource_requests_view": true,
          "resource_requests_create": true,
          "resource_requests_resolve": true,
          "rate_cards_view": true,
          "rate_cards_manage": true,
          "report_categories_manage": true,
          "insights_view": true,
          "insights_manage": true,
          "roles_view": true,
          "roles_manage": true,
          "sales_manage": true,
          "service_bookings_view_self": true,
          "service_bookings_view_restricted": true,
          "service_bookings_view_all": true,
          "service_bookings_manage": true,
          "service_bookings_view_tentative": true,
          "service_types_view": true,
          "service_types_manage": true,
          "subscription_manage_billing": true,
          "subscription_manage_seats": true,
          "subscription_manage": true,
          "surveys_manage": true,
          "tasks_view": true,
          "tasks_manage": true,
          "tax_rates_manage": true,
          "teams_view": true,
          "teams_manage": true,
          "time_entries_view_all": true,
          "time_entries_view_restricted": true,
          "time_entries_manage": true,
          "time_entries_manage_self": true,
          "time_entries_manage_locked": true,
          "time_entries_approve_restricted": true,
          "time_entries_approve_where_user_is_approver": true,
          "time_entries_approve_all": true,
          "time_off_bookings_view_all": true,
          "time_off_bookings_manage_self": true,
          "time_off_bookings_manage_all": true,
          "time_off_bookings_approve_all": true,
          "time_off_bookings_approve_restricted": true,
          "time_off_bookings_view_note": true,
          "time_off_bookings_view_inside_subsidiary": true,
          "time_reports_view_self": true,
          "time_reports_view_all": true,
          "time_tracking_policies_manage": true,
          "team_members_and_roles_view": true,
          "team_members_manage": true,
          "team_members_roles_manage": true,
          "clients_view": true,
          "clients_manage": true,
          "contacts_custom_field_values_view": true,
          "contacts_custom_field_values_manage": true,
          "contacts_sensitive_custom_field_values_view": true,
          "contacts_sensitive_custom_field_values_manage": true,
          "employees_field_values_view": true,
          "employees_field_values_manage": true,
          "employees_sensitive_custom_field_values_view": true,
          "employees_sensitive_custom_field_values_manage": true,
          "clients_deactivation_and_offboarding_manage": true,
          "team_members_deactivation_and_offboarding_manage": true,
          "webhooks_manage_webhooks": true,
          "webhooks_manage_own_zapier_triggers": true,
          "workflows_manage": true,
          "workload_items_view": true
        }
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2446"
          }
        }
      }
    },
    {
      "id": "6721",
      "type": "companies",
      "attributes": {
        "name": "Organization2447",
        "billing_name": null,
        "vat": null,
        "default_currency": null,
        "created_at": "2025-12-06T01:22:22.933+01:00",
        "last_activity_at": "2025-12-06T01:22:22.933+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": "2446"
          }
        },
        "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": "9384",
      "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,
        "resolved_permissions": {
          "allocations_view": false,
          "automations_manage": false,
          "bank_accounts_manage": false,
          "billables_view": false,
          "budgets_view_restricted": false,
          "budgets_view_all": false,
          "budgets_manage": false,
          "budgets_share": false,
          "budgets_scenarios_view": false,
          "budgets_scenarios_manage": false,
          "budgets_scenarios_apply": false,
          "companies_view": false,
          "companies_manage": false,
          "contacts_view": false,
          "contacts_manage": false,
          "team_members_contact_info_view": true,
          "cost_rates_view": false,
          "cost_rates_view_inside_subsidiary": false,
          "cost_rates_manage": false,
          "cost_rates_view_for_subordinates": false,
          "custom_fields_manage": false,
          "task_custom_fields_manage": false,
          "doc_custom_fields_manage": false,
          "deals_view_restricted": false,
          "deals_view_all": false,
          "deals_manage": false,
          "deals_share": false,
          "deals_scenarios_view": false,
          "deals_scenarios_manage": false,
          "deals_scenarios_apply": false,
          "deals_proposals_delete_signed": false,
          "document_types_and_styles_manage": false,
          "docs_manage": true,
          "docs_view": true,
          "emails_manage": false,
          "entitlements_view_self": true,
          "entitlements_view_all": false,
          "entitlements_manage": false,
          "entitlements_view_inside_subsidiary": false,
          "events_view": true,
          "events_manage": false,
          "expenses_view_self": true,
          "expenses_view_all": false,
          "expenses_view_restricted": false,
          "expenses_manage_self": true,
          "expenses_manage": false,
          "expenses_approve_where_deal_owner": false,
          "expenses_approve_restricted": false,
          "expenses_approve_all": false,
          "financials_locking_manage": false,
          "financial_item_reports_view": false,
          "holidays_manage": false,
          "imports_manage": false,
          "integrations_manage_organizational": false,
          "integrations_manage_personal": true,
          "integrations_manage_task_management": false,
          "integrations_view_task_management": true,
          "invoices_view_restricted": false,
          "invoices_view_all": false,
          "invoices_manage_draft": false,
          "invoices_manage_finalized": false,
          "invoices_limited_manage_finalized": false,
          "invoices_copy_to_accounting": false,
          "invoices_manage_intercompany": false,
          "invoices_send_to_client": false,
          "organization_administrate": false,
          "organization_polaris_access": false,
          "overheads_manage": false,
          "payments_view": false,
          "payments_manage": false,
          "payment_reminders_manage": false,
          "payment_reminder_sequences_manage": false,
          "placeholders_view": false,
          "placeholders_manage": false,
          "profitability_view": false,
          "projects_view_restricted": true,
          "projects_view_all": false,
          "projects_manage": false,
          "boards_manage": false,
          "task_lists_manage": true,
          "purchase_orders_view_restricted": false,
          "purchase_orders_manage": false,
          "resource_requests_view": false,
          "resource_requests_create": false,
          "resource_requests_resolve": false,
          "rate_cards_view": false,
          "rate_cards_manage": false,
          "report_categories_manage": false,
          "insights_view": false,
          "insights_manage": false,
          "roles_view": false,
          "roles_manage": false,
          "sales_manage": false,
          "service_bookings_view_self": true,
          "service_bookings_view_restricted": false,
          "service_bookings_view_all": false,
          "service_bookings_manage": false,
          "service_bookings_view_tentative": false,
          "service_types_view": true,
          "service_types_manage": false,
          "subscription_manage_billing": false,
          "subscription_manage_seats": false,
          "subscription_manage": false,
          "surveys_manage": false,
          "tasks_view": true,
          "tasks_manage": true,
          "tax_rates_manage": false,
          "teams_view": true,
          "teams_manage": false,
          "time_entries_view_all": false,
          "time_entries_view_restricted": false,
          "time_entries_manage": false,
          "time_entries_manage_self": true,
          "time_entries_manage_locked": false,
          "time_entries_approve_restricted": false,
          "time_entries_approve_where_user_is_approver": false,
          "time_entries_approve_all": false,
          "time_off_bookings_view_all": false,
          "time_off_bookings_manage_self": true,
          "time_off_bookings_manage_all": false,
          "time_off_bookings_approve_all": false,
          "time_off_bookings_approve_restricted": false,
          "time_off_bookings_view_note": false,
          "time_off_bookings_view_inside_subsidiary": false,
          "time_reports_view_self": true,
          "time_reports_view_all": false,
          "time_tracking_policies_manage": false,
          "team_members_and_roles_view": false,
          "team_members_manage": false,
          "team_members_roles_manage": false,
          "clients_view": false,
          "clients_manage": false,
          "contacts_custom_field_values_view": false,
          "contacts_custom_field_values_manage": false,
          "contacts_sensitive_custom_field_values_view": false,
          "contacts_sensitive_custom_field_values_manage": false,
          "employees_field_values_view": true,
          "employees_field_values_manage": false,
          "employees_sensitive_custom_field_values_view": false,
          "employees_sensitive_custom_field_values_manage": false,
          "clients_deactivation_and_offboarding_manage": false,
          "team_members_deactivation_and_offboarding_manage": false,
          "webhooks_manage_webhooks": false,
          "webhooks_manage_own_zapier_triggers": false,
          "workflows_manage": false,
          "workload_items_view": true
        }
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2446"
          }
        }
      }
    },
    {
      "id": "2897",
      "type": "workflow_statuses",
      "attributes": {
        "name": "Closed",
        "color_id": "1",
        "position": 1,
        "category_id": 3
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2446"
          }
        },
        "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 06 Dec 2025