PRproductive
Folders

Reposition a folder

Changed on

Reorders a folder among the other folders in its project. Pass move_before_id and/or move_after_id — the IDs of the folders to position it relative to. When both are provided, the folder is placed between them.

{
  "data": {
    "type": "folders",
    "attributes": { "move_after_id": 5521 }
  }
}
patch/api/v2/folders/{id}/reposition

Request

  • Base URL
    https://developer.productive.io (the document declares no server; this is the origin it was published from)
  • URL
    https://developer.productive.io/api/v2/folders/{id}/reposition
  • Auth
    none declared

Path parameters

idstring required

The numeric ID of the folder.

Request body

Example request

{
  "data": {
    "type": "folders",
    "attributes": {
      "move_after_id": 5521
    }
  }
}

Response

A single folder resource response.

Example response

{
  "data": {
    "id": "5522",
    "type": "folders",
    "attributes": {
      "name": "Features",
      "position": 1,
      "placement": 1000000,
      "archived_at": null,
      "hidden": false
    },
    "relationships": {
      "project": {
        "data": {
          "type": "projects",
          "id": "6899"
        }
      }
    }
  },
  "included": []
}

Changes

  • fa3060fd0144Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • f11a8740641aRevision changes
    • breaking

      the // response's property type changed from string to no type, and format from date-time to no format for status

    • breaking

      the // response's property type changed from integer to no type for status

    • breaking

      the // response's property type changed from integer to no type for status

    • warning

      deleted the header request parameter X-Organization-Id

    • info

      added to the // response property anyOf list for the response status

    • info

      added to the // response property anyOf list for the response status

    • info

      added subschema #2 to the // response property anyOf list for the response status

    • info

      added subschema #2 to the // response property anyOf list for the response status

    • info

      added subschema #2 to the // response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the // response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the // response property anyOf list for the response status

    • info

      the response property //// became required for the status

    • info

      the response property ///// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property ///// became required for the status

    This list may be incomplete.