Developers API reference Version 1 · generated from the code openapi.json
Routes

organize

Delete several items

POST /api/v1/bulk/delete

Each item follows its own rule: deleted for everyone when the account may, otherwise only removed from what is shared with it. This cannot be undone.

Required scope: delete

Request body application/json

  • items array of Item · required

    What to delete.

    2 fields
    • type string · required

      What it is.

    • id integer · required

      Its id.

Response

200 BulkDeleted

  • gone array of Item

    What left the views of the account: deleted, or its access given up.

    2 fields
    • type string

      What it is.

    • id integer

      Its id.

  • stayed integer

    Number of items that could not go.

Errors

  • 401

    No valid credential.

  • 403

    The credential lacks the required scope, or the account may not do this.

  • 409

    The current state of the content forbids the request.

  • 422

    A value is missing or malformed.

  • 429

    Too many requests; Retry-After gives the seconds to wait.

planner_banner_ad_pt