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

# Delete an artifact

> Permanently remove an organization report and revoke access to its bundled files.

Requires `samples:write`. Deletes the report for everyone in the organization.
Linked samples and jobs are retained. This operation cannot be undone.

A **200** response contains `{"id": "<artifact UUID>", "deleted": true}`.
Missing artifacts and IDs from another organization return **404**.

Report and asset access is revoked when the database row is removed. Storage
cleanup is best-effort, so a storage failure can leave inaccessible objects for
later cleanup.

```python theme={"dark"}
client.artifacts.delete(artifact_id)
```

The dashboard provides Delete actions with explicit confirmation on the artifact
list and report page. Use the dashboard, REST or Python SDK for permanent deletion. The curated MCP
catalog omits this operation.


## OpenAPI

````yaml DELETE /artifacts/{id}
openapi: 3.1.0
info:
  title: Strand AI Platform API
  version: v1
  description: >-
    REST surface for uploading WSIs, submitting Lattice inference jobs, and
    streaming results. All endpoints require an API key or Strand AI OAuth
    access token in the `Authorization: Bearer` header.
servers:
  - url: https://app.strandai.com/api/v1
    description: Production
security:
  - ApiKey: []
  - OAuth2: []
paths:
  /artifacts/{id}:
    delete:
      summary: Delete an artifact
      description: >-
        Permanently remove this organization's report. Revokes report and asset
        access immediately, then attempts best-effort bundled-object cleanup.
        Linked samples and jobs are retained. Requires samples:write. Cross-org
        and missing IDs return 404.
      operationId: deleteArtifact
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Artifact deleted
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - deleted
                properties:
                  id:
                    type: string
                    format: uuid
                  deleted:
                    type: boolean
                    enum:
                      - true
        '401':
          description: Missing or invalid credential
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Insufficient scopes or organization access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Artifact not found in this organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKey: []
        - OAuth2:
            - samples:write
components:
  schemas:
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: string
        message:
          type: string
        reason:
          type: string
          nullable: true
        required:
          type: integer
          nullable: true
        retryAfterSeconds:
          type: integer
          nullable: true
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: sk-strand-XXXXXXXXXXXXXXXXXXXXXXXX
    OAuth2:
      type: oauth2
      description: >-
        Strand AI authorization-code flow with S256 PKCE, explicit organization
        consent, and RFC 8707 resource binding.
      flows:
        authorizationCode:
          authorizationUrl: https://auth.strandai.com/oauth2/auth
          tokenUrl: https://auth.strandai.com/oauth2/token
          scopes:
            samples:read: Read slide metadata and estimates
            samples:write: Upload and change slides
            jobs:read: Read run status
            jobs:write: Start, export, or cancel runs
            results:read: Read and download results
            credits:spend: Reserve and spend organization credits

````

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