GUguesty
Accounts

Delete a custom field configuration

Changed on

Remove a custom field definition from the account. Returns the account's remaining custom fields.

delete/accounts/{id}/custom-fields/{field_id}

Request

  • Base URL
    https://open-api.guesty.com/v1
  • URL
    https://open-api.guesty.com/v1/accounts/{id}/custom-fields/{field_id}
  • Auth
    API key in header authorization

Path parameters

idstring required

Guesty account ID or me

field_idstring required

Custom field id

Response

The account's remaining custom fields, after the deletion. NOTE: items are keyed by _id here, not by fieldId as in the other custom field responses. Deleting is idempotent — a field_id that does not exist on the account is a no-op and still returns 200 with the unchanged list, not a 404.

displayNamestring

The internal variable name of the custom field. Read-only: it is derived by the server from key (trimmed, whitespace replaced with underscores, lowercased), so a value sent by the client is ignored.

isPublicboolean

Indicates whether the custom field is visible to all users or only those with custom field permissions.

isRequiredboolean

Whether a value must be supplied for this field. Applies to reservation custom fields only — it is ignored for listing custom fields, which the Guesty UI always creates with isRequired: false.

keystring

The plain text display name of the custom field

object'listing' | 'reservation'

Whether the custom field is for listings or reservations

optionsstring[]

Your custom list of options, for the enum field type. For type: user the system populates the options internally with the account's users, but this property is still returned as an empty array — an empty array here does not mean the account has no users.

type'boolean' | 'contact' | 'date' | 'dayofweek' | 'enum' | 'longtext' | 'number' | 'text' | 'time' | 'user'

The data type of the custom field. Indicates the type of content that can be input into the field. The "Team member" option in the Guesty UI creates a field of type user — there is no separate team_member type, and both produce the same result.

_idstring

The unique identifier of the custom field. Equivalent to fieldId in the other custom field responses.

Example response

[
  {
    "_id": "5dc03b42e28baf001e2b35d0"
  }
]

Changes

  • 3122b8618183Revision changes
    • breaking

      the response's property type changed from object to no type for status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      api operation id accountsCustomFieldDelete was added

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added subschema #1 subschema #2 to the response property allOf list for the response status