PRproductive
Scenario Bookings

Create a scenario booking

Changed on

Create a new scenario booking. Requires the Scenario Builder feature on the organization's plan.

post/api/v2/scenario_bookings

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

Request body

Example request

{
  "data": {
    "type": "scenario_bookings",
    "attributes": {
      "scenario_item_id": 301,
      "booking_method_id": 1,
      "time": 240,
      "started_on": "2026-03-02",
      "ended_on": "2026-03-13"
    }
  }
}

Response

Single scenario booking

Example response

{
  "data": {
    "id": "401",
    "type": "scenario_bookings",
    "attributes": {
      "time": 240,
      "total_time": 2400,
      "started_on": "2026-03-02",
      "ended_on": "2026-03-13",
      "booking_method_id": 1,
      "total_working_days": 10,
      "note": "Kickoff sprint"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "1"
        }
      },
      "scenario_item": {
        "data": {
          "type": "scenario_items",
          "id": "301"
        }
      },
      "creator": {
        "data": {
          "type": "people",
          "id": "7"
        }
      }
    }
  }
}

Changes

  • fa3060fd0144Revision changes
    • warning

      added the new bad_decimal_format enum value to the // response property for the response status

    • warning

      added the new non_finite_number enum value to the // response property for the response status

    • warning

      added the new null_bytes_in_params enum value to the // response property for the response 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