> ## 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 an account

> Soft-deletes the account, as the app's own delete does when it cannot hard-delete: it leaves every list and a GET on it is a 404. Its values, owners and activity are kept; its type becomes Deleted, so the type it had is not kept. Deleting an account that is already deleted returns the same answer and changes nothing. There is no hard delete over the API.



## OpenAPI

````yaml /api/statisfy-api.openapi.json delete /v1/objects/account/records/{account_id}
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/objects/account/records/{account_id}:
    delete:
      tags:
        - accounts
      summary: Delete an account
      description: >-
        Soft-deletes the account, as the app's own delete does when it cannot
        hard-delete: it leaves every list and a GET on it is a 404. Its values,
        owners and activity are kept; its type becomes Deleted, so the type it
        had is not kept. Deleting an account that is already deleted returns the
        same answer and changes nothing. There is no hard delete over the API.
      operationId: accounts_delete
      parameters:
        - in: path
          name: account_id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletedAccount'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    DeletedAccount:
      properties:
        deleted:
          const: true
          default: true
          title: Deleted
          type: boolean
        id:
          title: Id
          type: string
      required:
        - id
      title: DeletedAccount
      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.