Sign in
worker

Delete a batch of objects with a given prefix

Deletes all objects with the provided prefix from the database. The data is not removed from the network immediately. Instead, the autopilot prunes data from the contracts periodically, after that happens the host is no longer obliged to store the data and it's effectively removed from the network.

post/worker/objects/remove

Request body

bucketstring

The name of the bucket the objects belong to

prefixstring

The prefix of the objects to delete

Example request

{
  "bucket": "default",
  "prefix": "folder/file"
}

Response

Successfully removed objects

Changes

Changed in 7 of the 50 revisions of this API.914

  • c38282599c5a21See the full diff
    • ▲

      added ObjectKey subschema #2 to the prefix request property allOf list

      request-property-all-of-added

    • ▲

      the prefix request property type/format changed from string/ to /

      request-property-type-changed

    • ○

      the prefix request property's minLength was decreased from 1 to 0

      request-property-min-length-decreased

  • 922f156353c921See the full diff
    • ▲

      removed the media type text/plain for the response with the status 404

      response-media-type-removed

    • ▲

      removed the media type text/plain for the response with the status 500

      response-media-type-removed

    • ○

      api tag worker added

      api-tag-added

  • be2f724d7cd41See the full diff
    • ▲

      removed the media type text/plain for the response with the status 200

      response-media-type-removed

  • 1a4b05c71ba911See the full diff
    • ▲

      added BucketName to the bucket request property allOf list

      request-property-all-of-added

    • ●

      removed Bucket from the bucket request property allOf list

      request-property-all-of-removed

  • 9bd8635d818c21See the full diff
    • ▲

      added Bucket subschema #2 to the bucket request property allOf list

      request-property-all-of-added

    • ▲

      the bucket request property type/format changed from string/ to /

      request-property-type-changed

    • ○

      removed the pattern (?!(^xn--|.+-s3alias$))^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$ from the request property bucket

      request-property-pattern-removed

  • 2700783521b01See the full diff
    • ○

      endpoint added

      endpoint-added

  • f062c35d8f471See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 99 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog