---
updatedAt: 2026-03-13T14:16:31.000Z
agentTools:
  projectIndex: https://docs.fulcrumapp.com/llms.txt
---

# Delete Record

Delete a record from your organization.

# API Library Examples

```python Python
from fulcrum import Fulcrum
fulcrum = Fulcrum('{token}')

fulcrum.records.delete('{id}')
print('{id} has been deleted!')
```
```javascript JavaScript
const { Client } = require('fulcrum-app');
const client = new Client('{token}');

client.records.delete('{id}')
  .then((record) => {
    console.log('{id} has been deleted!');
  })
  .catch((error) => {
    console.log(error.message);
  });
```
```ruby Ruby
require 'fulcrum'

client = Fulcrum::Client.new('{token}')

client.records.delete('{id}')

puts '{id} has been deleted!'
```

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "rest-api",
    "version": "2"
  },
  "servers": [
    {
      "url": "https://api.fulcrumapp.com/api",
      "description": "United States"
    },
    {
      "url": "https://api.fulcrumapp-au.com/api",
      "description": "Australia"
    },
    {
      "url": "https://api.fulcrumapp-ca.com/api",
      "description": "Canada"
    },
    {
      "url": "https://api.fulcrumapp-eu.com/api",
      "description": "European Union"
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiToken": {
        "type": "apiKey",
        "in": "header",
        "name": "X-ApiToken"
      }
    },
    "schemas": {
      "Geometry": {
        "type": "object",
        "required": [
          "type",
          "coordinates"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "Point",
              "LineString",
              "Polygon",
              "MultiPoint",
              "MultiLineString",
              "MultiPolygon"
            ],
            "description": "GeoJSON geometry type"
          },
          "coordinates": {
            "description": "Coordinates for the geometry. Format varies by type: Point uses [longitude, latitude], LineString uses array of positions, Polygon uses array of linear rings (first is exterior, rest are holes), Multi* types use arrays of their respective coordinate structures."
          }
        }
      },
      "SingleRecordResponse": {
        "type": "object",
        "required": [
          "record"
        ],
        "properties": {
          "record": {
            "$ref": "#/components/schemas/Record"
          }
        }
      },
      "Record": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "nullable": true
          },
          "version": {
            "type": "integer"
          },
          "id": {
            "type": "string",
            "pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "client_created_at": {
            "type": "string",
            "nullable": true,
            "format": "date-time"
          },
          "client_updated_at": {
            "type": "string",
            "nullable": true,
            "format": "date-time"
          },
          "created_by": {
            "type": "string"
          },
          "created_by_id": {
            "type": "string",
            "pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
          },
          "updated_by": {
            "type": "string"
          },
          "updated_by_id": {
            "type": "string",
            "pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
          },
          "created_location": {
            "$ref": "#/components/schemas/AuditLocation"
          },
          "updated_location": {
            "$ref": "#/components/schemas/AuditLocation"
          },
          "created_duration": {
            "type": "number",
            "nullable": true
          },
          "updated_duration": {
            "type": "number",
            "nullable": true
          },
          "edited_duration": {
            "type": "number",
            "nullable": true
          },
          "form_id": {
            "type": "string",
            "pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
          },
          "project_id": {
            "type": "string",
            "nullable": true
          },
          "record_series_id": {
            "type": "string",
            "nullable": true
          },
          "assigned_to": {
            "type": "string",
            "nullable": true
          },
          "assigned_to_id": {
            "type": "string",
            "nullable": true
          },
          "form_values": {
            "type": "object",
            "additionalProperties": true,
            "description": "Field values keyed by field key - values can be strings, objects, or arrays depending on field type"
          },
          "latitude": {
            "type": "number",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "nullable": true
          },
          "altitude": {
            "type": "number",
            "nullable": true
          },
          "geometry": {
            "$ref": "#/components/schemas/Geometry"
          },
          "gps_device_capture": {
            "$ref": "#/components/schemas/GpsDeviceCaptureBase",
            "nullable": true,
            "description": "Flexible GPS device metadata captured with the record."
          },
          "speed": {
            "type": "number",
            "nullable": true
          },
          "course": {
            "type": "number",
            "nullable": true
          },
          "horizontal_accuracy": {
            "type": "number",
            "nullable": true
          },
          "vertical_accuracy": {
            "type": "number",
            "nullable": true
          },
          "system_status": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "AuditLocation": {
        "type": "object",
        "nullable": true,
        "properties": {
          "latitude": {
            "type": "number",
            "format": "double",
            "nullable": true,
            "description": "The latitude coordinate."
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "nullable": true,
            "description": "The longitude coordinate."
          },
          "altitude": {
            "type": "number",
            "format": "double",
            "nullable": true,
            "description": "The altitude in meters."
          },
          "horizontal_accuracy": {
            "type": "number",
            "format": "double",
            "nullable": true,
            "description": "The horizontal accuracy in meters."
          }
        },
        "description": "Location metadata captured at creation or update time."
      },
      "GpsDeviceCaptureBase": {
        "type": "object",
        "description": "Flexible GPS device metadata captured with a record.",
        "additionalProperties": true,
        "properties": {
          "device_name": {
            "type": "string",
            "description": "Name of the GPS device"
          },
          "manufacturer": {
            "type": "string",
            "description": "Manufacturer of the GPS device"
          },
          "fix_type": {
            "type": "string",
            "description": "Type of GPS fix"
          },
          "satellite_count": {
            "type": "integer",
            "description": "Number of satellites used for the fix"
          },
          "hdop": {
            "type": "number",
            "description": "Horizontal dilution of precision"
          },
          "vdop": {
            "type": "number",
            "description": "Vertical dilution of precision"
          },
          "pdop": {
            "type": "number",
            "description": "Position dilution of precision"
          },
          "differential_correction": {
            "type": "boolean",
            "description": "Whether differential correction was used"
          },
          "antenna_height": {
            "type": "number",
            "description": "Antenna height in meters"
          },
          "firmware_version": {
            "type": "string",
            "description": "Device firmware version"
          },
          "geometry": {
            "$ref": "#/components/schemas/Geometry",
            "description": "GPS-captured geometry reference."
          }
        }
      },
      "BadRequestResponse": {
        "type": "object",
        "description": "Bad request error response",
        "properties": {
          "error": {
            "type": "string",
            "example": "Bad Request"
          },
          "status": {
            "type": "integer",
            "example": 400
          }
        }
      }
    }
  },
  "security": [
    {
      "ApiToken": []
    }
  ],
  "paths": {
    "/v2/records/{record_id}.json": {
      "delete": {
        "summary": "Delete a record",
        "description": "Delete a record from your organization.",
        "operationId": "records-delete",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "description": "The unique identifier of the record to delete.",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "Accept",
            "in": "header",
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "X-SkipWorkflows",
            "in": "header",
            "description": "Skips all app workflows",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "X-SkipWebhooks",
            "in": "header",
            "description": "Skips all app webhooks",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SingleRecordResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BadRequestResponse"
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```