Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.docs.onlydrams.app/llms.txt

Use this file to discover all available pages before exploring further.

Returns the newly created Blind Instance object.

​
Parameters

No parameters.

​
Returns

Returns a newly created Blind Instance object for the specified Blind if one if one is successfully created. If is it not saved, or the logged in user does not have access, an error will be returned instead. Note: If the user does not have enough matching bottles, a special error is returned. 
  curl -H "Authorization: $ACCESS_TOKEN" \
    --request POST \
    --url https://api.onlydrams.app/api/v1/blinds/:blind_id/blind_instances

  {
    "id":"faf32869-8cfe-458c-8f1f-032d5c5c4f2d",
    "time_to_complete":null,
    "blind":
      {
        "id":"5f0b220b-d7a4-4080-96e4-c9b2dd04f435",
        "name":"Nyarlathotep",
        "number_of_bottles":4,
        "proof_low":null,
        "proof_high":null,
        "price_low":null,
        "price_high":null,
        "types":null,
        "distillery_ids":null
      },
    "blind_bottles":[
      {
        "id":"ed7faf81-f35d-431b-9f65-c9ba55cf7bde",
        "nose_rating":null,
        "pallette_rating":null,
        "bottle":
          {
            "id":"0ab8662c-093c-4ef1-887f-4bc1ca55af99",
            "price":5.83,
            "secondary":0.0,
            "secondary_outer_bound":0.0,
            "enhanced_pricing":false,
            "rarity":"common",
            "size":"750",
            "image_url":null,
            "juice":
              {
                "id":"75898894-46ef-433c-bb52-73ef92a11f14",
                "name":"Enchanted Isles",
                "age":18,
                "proof":40.4,
                "variety":"scotch",
                "origin":"North Carolina",
                "release":null,
                "rarity":"common",
                "sizes":[
                  {
                    "id":"0ab8662c-093c-4ef1-887f-4bc1ca55af99",
                    "size":"750",
                    "price":5.83,
                    "secondary":0.0,
                    "secondary_outer_bound":0.0,
                    "rarity":"common",
                    "image_url":null,
                    "sku":"756432751897",
                    "optionals":[]
                  }
                ],
                "distillery":
                  {
                    "id":"4ac1f1f3-908b-4c6a-ab33-96a587919b0b",
                    "name":"willett"
                  },
                "review_count":0,
                "average_rating":0,
                "territories":[],
                "mashbill":[],
                "months_old":null,
                "days_old":null,
                "pickable":false,
                "finish_cask_type":[],
                "notes":null
              },
            "optionals":[],
            "batches":[],
            "vintages":[]
          },
        "guessed_bottle":null,
        "correct":false
    }
  ]
}

​
Error Responses

It can return one of two errors (outside of permission or server errors):
  • 422 and an error message if it does not save for some reason
  • 406 and a error message of “We couldn’t find enough matching bottles in your collection. Adjust your criteria and try again.” if the user does not have enough matching bottles in their collection.