PRproductive
Project Preferences

Get project preferences

Changed on

Returns a paginated list of project preferences, limited to projects the current user can see. Scope the list with filter[project_id] or filter[person_id].

get/api/v2/project_preferences

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/project_preferences
  • Auth
    none declared

Query parameters

OR

Filter conditions for the project preference list. Supports filtering by id, person_id and project_id.

{
  "0": {
    "person_id": {
      "eq": "12"
    }
  },
  "1": {
    "project_id": {
      "eq": "6899"
    }
  },
  "$op": "or"
}
sortstring[]

Sort order for project preference list results. Accepts one or more field names, comma-separated; prefix with - for descending.

Response

Paginated list of project preferences.

Example response

{
  "data": [
    {
      "id": "32234",
      "type": "project_preferences",
      "attributes": {
        "tasks_layout_id": 104,
        "created_at": "2026-01-20T10:00:00.000+00:00",
        "preferences": "{\"project_last_tab\":\"tasks\",\"default_tab_id\":\"1867-project-tasks\"}",
        "watched": false
      },
      "relationships": {
        "person": {
          "data": {
            "type": "people",
            "id": "12"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "6899"
          }
        }
      }
    }
  ],
  "included": [],
  "meta": {
    "current_page": 1,
    "total_pages": 5,
    "total_count": 42,
    "page_size": 30,
    "max_page_size": 200
  }
}

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

  • f11a8740641aRevision changes
    • breaking

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

    • breaking

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

    • breaking

      the /// response's property type changed from boolean 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.