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

# Delete Contact Data

> Delete the stored data for a contact phone number

Use this endpoint when the state stored against a caller's phone number is no
longer needed. Deletion removes the current value from reads while keeping the
contact itself and its revision history.

Deletion is idempotent. If no current data exists, the endpoint still returns
success with `"deleted": false`.

Data is scoped to your organization. US numbers can be formatted or sent as
digits. Non-US numbers must include the `+` country code. URL-encode the `+`
when it appears in the path.

```bash theme={null}
curl -X DELETE 'https://api.usesimple.ai/api/v1/contacts/14155550100/data' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

The response confirms the normalized phone number and whether a current value
was deleted:

```json theme={null}
{
  "phoneNumber": "+14155550100",
  "deleted": true
}
```

The endpoint returns `401` when authentication fails and `422` when the phone
number is invalid.


## OpenAPI

````yaml DELETE /contacts/{phoneNumber}/data
openapi: 3.1.0
info:
  title: Public API v1
  description: >-
    Public API v1 requiring API keys.


    **Timestamps:** All datetime fields in API responses are returned in UTC
    using ISO 8601 format (e.g., `2024-01-15T14:30:00Z`). When filtering by date
    parameters, provide timestamps in ISO 8601 format.
  version: 0.1.0
servers:
  - url: https://api.prod.usesimple.ai/api/v1
    description: Production API Server
security: []
paths:
  /contacts/{phoneNumber}/data:
    delete:
      tags:
        - Contacts
      summary: Delete Contact Data
      description: >-
        Delete the current JSON object stored for a phone number. Deletion is
        idempotent and preserves revision history.
      operationId: delete_contact_data_contacts__phoneNumber__data_delete
      parameters:
        - name: phoneNumber
          in: path
          required: true
          schema:
            type: string
          description: >-
            The caller's phone number. US numbers may be formatted or sent as
            digits; non-US numbers must include the + country code.
      responses:
        '200':
          description: Contact data deletion result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteContactDataResponse'
        '401':
          description: Authentication failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '422':
          description: The phone number is invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    DeleteContactDataResponse:
      type: object
      required:
        - phoneNumber
        - deleted
      properties:
        phoneNumber:
          type: string
          description: The normalized phone number in E.164 format.
        deleted:
          type: boolean
          description: Whether a current value was deleted.
      title: Delete Contact Data Response
    PublicApiError:
      type: object
      required:
        - status
        - success
        - error
        - errors
      properties:
        status:
          type: string
          const: error
        success:
          type: boolean
          const: false
        error:
          type: string
        errors:
          type: array
          items:
            type: string
      title: Public API Error
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: Authorization

````