> ## Documentation Index
> Fetch the complete documentation index at: https://help.statisfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a custom field

> Deletes a custom field created in Statisfy (in the app or with `POST /v1/fields`) and its value on every record. This cannot be undone. A field from a CRM or a system field cannot be deleted (a 422); a standard field is not a custom field (a 404). A field that other data still uses, such as an AI field's value history, is a 409 and nothing changes. A project's and a task's custom fields are one set, so a delete through either object removes the field from both. On a custom object, a field its CRM fills, and any field of an object a warehouse or another system fills, can't be deleted (a 422): the next sync would bring it back. A repeat finds no field: a 404, and nothing more is deleted.



## OpenAPI

````yaml /api/statisfy-api.openapi.json delete /v1/fields/{field_key}
openapi: 3.1.0
info:
  description: >-
    The agent-first Statisfy API. Authenticate with an API key (`Authorization:
    Bearer stfy_live_…`), then call `GET /v1/meta/capabilities` to discover
    every operation and its schemas.
  title: Statisfy API
  version: 1.0.0
servers:
  - url: https://api.statisfy.com
    description: Production
security: []
paths:
  /v1/fields/{field_key}:
    delete:
      tags:
        - fields
      summary: Delete a custom field
      description: >-
        Deletes a custom field created in Statisfy (in the app or with `POST
        /v1/fields`) and its value on every record. This cannot be undone. A
        field from a CRM or a system field cannot be deleted (a 422); a standard
        field is not a custom field (a 404). A field that other data still uses,
        such as an AI field's value history, is a 409 and nothing changes. A
        project's and a task's custom fields are one set, so a delete through
        either object removes the field from both. On a custom object, a field
        its CRM fills, and any field of an object a warehouse or another system
        fills, can't be deleted (a 422): the next sync would bring it back. A
        repeat finds no field: a 404, and nothing more is deleted.
      operationId: fields_delete
      parameters:
        - description: The field's key, as `GET /v1/fields` lists it
          in: path
          name: field_key
          required: true
          schema:
            examples:
              - renewal_risk__c_
            maxLength: 255
            minLength: 1
            type: string
        - description: >-
            The object the field belongs to: one of account, contact,
            opportunity, project, task, user, or a custom object's key. A
            project's and a task's custom fields are one set: a delete through
            either removes the field from both
          in: query
          name: object
          required: true
          schema:
            maxLength: 200
            minLength: 1
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletedField'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    DeletedField:
      properties:
        deleted:
          const: true
          default: true
          title: Deleted
          type: boolean
        key:
          description: The deleted field's key
          title: Key
          type: string
        object:
          description: The object named in the request
          title: Object
          type: string
      required:
        - key
        - object
      title: DeletedField
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http
      description: >-
        An API key, sent as `Authorization: Bearer stfy_live_…`. See
        [Authentication](/rest-api/authentication) for how to get one and which
        scopes it needs.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.