---
reference:
  curl:
    - key: delete_object
      id: delete_object
      url: /reference/vault/object/delete
      title: '/vault/v1/kv/:id'
      type: DELETE
      parameters:
        - (object.id)
        - key: version_check
          optional: true
          type: string
          description: (object_metadata.version_check)
      returns:
        - key: success
          type: boolean
          description: Flag indicating whether the object was successfully deleted.
        - (object.name)
  js:
    - key: deleteObject
      id: delete_object
      url: /reference/vault/object/delete
      title: vault.deleteObject()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - (Object.id)
            - key: version_check
              optional: true
              type: string
              description: (object_metadata.version_check)
      returns:
        - key: success
          type: boolean
          description: Flag indicating whether the object was successfully deleted.
        - (Object.name)
  go:
    - key: DeleteObject
      id: delete_object
      url: /reference/vault/object/delete
      title: vault.DeleteObject()
      parameters:
        - (ctx)
        - key: opts
          type: vault.DeleteObjectOpts
          expanded: true
          properties:
            - (Object.Id)
            - key: VersionCheck
              optional: true
              type: string
              description: (object_metadata.version_check)
      returns:
        - key: response
          type: vault.DeleteObjectResponse
          expanded: true
          properties:
            - key: Success
              type: boolean
              description: Flag indicating whether the object was successfully deleted.
            - (Object.Name)
  python:
    - key: delete_object
      id: delete_object
      url: /reference/vault/object/delete
      title: vault.delete_object()
      parameters:
        - key: object_id
          type: str
          description: (object.id)
      returns:
        - key: None
          description: This method does not return a value
originalPath: .tmp-workos-clone/packages/docs/content/reference/vault/object/delete.mdx
---

## Delete an object

Permanently delete an object.

<CodeBlock referenceId="delete_object">
  <CodeBlockTab title="Request" file="delete-object-request" />
  <CodeBlockTab title="Response" file="delete-object-response" />
</CodeBlock>