Sign in

v3

latestSwagger 2.02026-08-067506752.0 MB
form

Update an existing form

patch/v1/org/{orgId}/form/{formId}

Path parameters

orgIdstring required

Org identifier (either id or slug)

formIdstring required

Form id

Request body

labelstring

human-readable full name of form

displayNamestring

display name of form during completion

descriptionstring

description of form

status'ACTIVE' | 'INACTIVE' | 'ARCHIVED'

status of the form

type'BUILT_IN' | 'CUSTOM'

type of the form

targetType'NONE' | 'PERSON'

target type that the form can be filled out about

targetFilterstring

filter that controls on which profiles this tab will appear

submitFilterstring

filter that controls which respondents can submit this form. The form:submit permission, if present, overrides this filter

responseReadFilterstring

filter that controls who can read the form responses. The formResponse:read permission, if present, overrides this filter

approval'MANAGER' | 'GRAND_MANAGER'

approval needed, if any approval is required

release'SUBMITTER' | 'ADMIN'

whether a release step is involved (subsequent to approval if any)

share'SUBMITTER' | 'ADMIN'

whether sharing form responses is allowed

authorSensitive'ANONYMOUS' | 'PRIVATE' | 'HIGH' | 'MANAGER'

view sensitivity for the author of this form - the level of view access required to view the createId and updateId fields. If null, the author's identity is always visible as long as the viewer can read the form response. If set to PRIVATE, the author's identity is stored in ChartHop, but protected such that even users with sensitive access cannot access the data. If set to ANONYMOUS, the author's identity is not stored in ChartHop at all.

completeMode'MODAL' | 'FULLSCREEN'

appearance of the form during completion

Example request

{
  "label": "Health Index: Q2",
  "displayName": "Health Index",
  "description": "The Engineering department, where engineers develop new technology and products.",
  "blocks": [
    {
      "id": "588f7ee98f138b19220041a7",
      "questionId": "588f7ee98f138b19220041a7"
    }
  ],
  "signature": {
    "fieldId": "588f7ee98f138b19220041a7"
  },
  "options": {
    "notifyUserIds": [
      "588f7ee98f138b19220041a7"
    ]
  },
  "ai": {
    "agentUserId": "588f7ee98f138b19220041a7"
  }
}

Response

form updated