General

I suggest you ...

You've used all your votes and won't be able to post a new idea, but you can still search and comment on existing ideas.

There are two ways to get more votes:

  • When an admin closes an idea you've voted on, you'll get your votes back from that idea.
  • You can remove your votes from an open idea you support.
  • To see ideas you have already voted on, select the "My feedback" filter and select "My open ideas".
(thinking…)

Enter your idea and we'll search to see if someone has already suggested it.

If a similar idea already exists, you can support and comment on it.

If it doesn't exist, you can post your idea so others can support it.

Enter your idea and we'll search to see if someone has already suggested it.

  1. Don't Show Deleted Github Branches

    The branch drop down in the editor shows all branches that have ever been created, even after they have been deleted from Github.

    It should show only the existing branches.

    5 votes
    Vote
    Sign in
    Check!
    (thinking…)
    Reset
    or sign in with
    • facebook
    • google
      Password icon
      I agree to the terms of service
      Signed in as (Sign out)
      You have left! (?) (thinking…)
    • Memory leak on editor

      I'm running Apiary on Chrome 51.0.2704.63 beta (64-bit) @ Ubuntu 14.04 , and I'm getting a large memory usage, slowness when using the preview Example.

      My Chrome running only the Apiary editor is using about 1GB of memory in a small API with a few actions.

      8 votes
      Vote
      Sign in
      Check!
      (thinking…)
      Reset
      or sign in with
      • facebook
      • google
        Password icon
        I agree to the terms of service
        Signed in as (Sign out)
        You have left! (?) (thinking…)
      • Enable Run in Postman

        It would be pretty slick if you could enable a "Run In Postman" button: https://www.getpostman.com/integrations/run-button?source=chrome_app The Apiary runner is decent, but many people would probably like to more easily call the services in Postman.

        7 votes
        Vote
        Sign in
        Check!
        (thinking…)
        Reset
        or sign in with
        • facebook
        • google
          Password icon
          I agree to the terms of service
          Signed in as (Sign out)
          You have left! (?) (thinking…)
        • Better support touchscreen PC devices on Google Chrome

          The problem is that on touchscreen device with Windows 10 + Google Chrome (all versions I have tried) I can't select and copy any text from my API documentation.

          When I click on some text and move the mouse pointer to select a text instead marking a text web panels starts moving as though I touch and swipe by fingers - so I can't select any text.

          It is very, very frustrating. Always when I want to copy something I have to open other web browser.

          In Firefox, Opera and Edge it is working correctly.
          In Chrome it works only…

          6 votes
          Vote
          Sign in
          Check!
          (thinking…)
          Reset
          or sign in with
          • facebook
          • google
            Password icon
            I agree to the terms of service
            Signed in as (Sign out)
            You have left! (?) (thinking…)
          • highlighting

            Fix syntax highlighting of words with underscores. Specifically, params, descriptions and JSON responses that have params with underscores in them currently start highlighting in the middle of the word (at the underscore). Likely, this must be considerably hindering page parsing & processing.

            6 votes
            Vote
            Sign in
            Check!
            (thinking…)
            Reset
            or sign in with
            • facebook
            • google
              Password icon
              I agree to the terms of service
              Signed in as (Sign out)
              You have left! (?) (thinking…)
            • Allow for versions of the API

              We're rolling out a new version of our API and would love to have a way to have documentation for v1 and v2 available.

              26 votes
              Vote
              Sign in
              Check!
              (thinking…)
              Reset
              or sign in with
              • facebook
              • google
                Password icon
                I agree to the terms of service
                Signed in as (Sign out)
                You have left! (?) (thinking…)
              • Autosave

                In editor, enable autosave option so I don't have to hit 'save' manually while editing.

                28 votes
                Vote
                Sign in
                Check!
                (thinking…)
                Reset
                or sign in with
                • facebook
                • google
                  Password icon
                  I agree to the terms of service
                  Signed in as (Sign out)
                  You have left! (?) (thinking…)
                • Programmable mock server

                  Provide an ability to express non-trivial logic for mock server responses.

                  Examples are like "If X in incoming header is greater then Y, return response 2 with value of Z equal to 20".

                  17 votes
                  Vote
                  Sign in
                  Check!
                  (thinking…)
                  Reset
                  or sign in with
                  • facebook
                  • google
                    Password icon
                    I agree to the terms of service
                    Signed in as (Sign out)
                    You have left! (?) (thinking…)
                  • JSON-RPC Support

                    It would be nice if you supported overloading the same URI for JSON-RPC and other RPC based APIs. Then allow the action to define the json-rpc method. At the moment when I provide multiple actions with the same verb (i.e. POST) to the same resource the editor give a warning the console will only return the Response for the first defined action.

                    You could possibly accomplish this by adding another META tag in the header i.e.:

                    FORMAT: 1A
                    HOST: https://api.qwasi.com
                    PROTOCOL: JSON-RPC

                    Then the parser would then know to allow overloads of resources (multiple resources with same URI).

                    13 votes
                    Vote
                    Sign in
                    Check!
                    (thinking…)
                    Reset
                    or sign in with
                    • facebook
                    • google
                      Password icon
                      I agree to the terms of service
                      Signed in as (Sign out)
                      You have left! (?) (thinking…)
                      under review  ·  Lukas LinhartLukas Linhart responded

                      The blueprint is now strongly biast towards request-response usage pattern. However, we are researching a version where protocol would be abstracted away, making JSON-RPC support possible. I cannot give any ETA for this, though.

                    • Allow repeated HTTP Headers defined in the Response

                      Apiary only supports one occurrence of each Response Header. If multiple headers are included in the API Blueprint, only the last one is represented in the documentation.

                      This is problematic when documenting that an API Response sets multiple cookies.

                      Per RFC 6265: " Origin servers SHOULD NOT fold multiple Set-Cookie header fields into a single header field. The usual mechanism for folding HTTP headers fields (i.e., as defined in [RFC2616]) might change the semantics of the Set-Cookie header field because the %x2C (",") character is used by Set-Cookie in a way that conflicts with such folding."

                      Suggestion: Modify the behavior…

                      12 votes
                      Vote
                      Sign in
                      Check!
                      (thinking…)
                      Reset
                      or sign in with
                      • facebook
                      • google
                        Password icon
                        I agree to the terms of service
                        Signed in as (Sign out)
                        You have left! (?) (thinking…)
                      • Add GitLab support, similar to GitHub

                        GitLab ist a cloud- or self-hosted code colaboration platform.

                        35 votes
                        Vote
                        Sign in
                        Check!
                        (thinking…)
                        Reset
                        or sign in with
                        • facebook
                        • google
                          Password icon
                          I agree to the terms of service
                          Signed in as (Sign out)
                          You have left! (?) (thinking…)
                        • Plugin for WebStorm

                          Create plugin to display markdown in WebStorm IDE like:
                          https://plugins.jetbrains.com/plugin/7701

                          10 votes
                          Vote
                          Sign in
                          Check!
                          (thinking…)
                          Reset
                          or sign in with
                          • facebook
                          • google
                            Password icon
                            I agree to the terms of service
                            Signed in as (Sign out)
                            You have left! (?) (thinking…)
                          • Allow generate response attribute as random value

                            for example:

                            {"response":OK, "recordid":@random(100000)@}

                            15 votes
                            Vote
                            Sign in
                            Check!
                            (thinking…)
                            Reset
                            or sign in with
                            • facebook
                            • google
                              Password icon
                              I agree to the terms of service
                              Signed in as (Sign out)
                              You have left! (?) (thinking…)
                              under review  ·  Lukas LinhartLukas Linhart responded

                              We are investigating such options under an umbrella term of “Programmable mock server”.

                            • Link with Google drive

                              I would be really happy if i can store the apib files inside my own drive instead of your server. Such that only the UI that is generated is from the file in my system.

                              4 votes
                              Vote
                              Sign in
                              Check!
                              (thinking…)
                              Reset
                              or sign in with
                              • facebook
                              • google
                                Password icon
                                I agree to the terms of service
                                Signed in as (Sign out)
                                You have left! (?) (thinking…)
                              • JSON validation

                                Display warning if example JSON in request/response is not well-formed.

                                32 votes
                                Vote
                                Sign in
                                Check!
                                (thinking…)
                                Reset
                                or sign in with
                                • facebook
                                • google
                                  Password icon
                                  I agree to the terms of service
                                  Signed in as (Sign out)
                                  You have left! (?) (thinking…)
                                • Support spell checking through a commercially available dictionary, such as Merriam-Webster.

                                  Support spell checking through a commercially available dictionary, such as Merriam-Webster. Allow highlighting of the text to be spell checked so that it does not spell check the code part.

                                  7 votes
                                  Vote
                                  Sign in
                                  Check!
                                  (thinking…)
                                  Reset
                                  or sign in with
                                  • facebook
                                  • google
                                    Password icon
                                    I agree to the terms of service
                                    Signed in as (Sign out)
                                    You have left! (?) (thinking…)
                                    under review  ·  Lukas LinhartLukas Linhart responded

                                    Thanks for your feedback. I’ll leave this idea open to see what the interest in such feature is.

                                  • Add a "Scroll to source" feature

                                    So when I click on a line in the preview, the editor will scroll to the matching line in the editor. The other way will also help (scroll to preview)

                                    6 votes
                                    Vote
                                    Sign in
                                    Check!
                                    (thinking…)
                                    Reset
                                    or sign in with
                                    • facebook
                                    • google
                                      Password icon
                                      I agree to the terms of service
                                      Signed in as (Sign out)
                                      You have left! (?) (thinking…)
                                      under review  ·  1 comment  ·  Admin →
                                    • Improve navigation in Blueprint view

                                      For large APIs with 30+ objects navigation becomes quite difficult in Blueprint view. It would be great if there was some kind of index (as in the Documentation view) that allowed navigation to a particular object quickly.

                                      17 votes
                                      Vote
                                      Sign in
                                      Check!
                                      (thinking…)
                                      Reset
                                      or sign in with
                                      • facebook
                                      • google
                                        Password icon
                                        I agree to the terms of service
                                        Signed in as (Sign out)
                                        You have left! (?) (thinking…)
                                        1 comment  ·  Admin →
                                      • Api management with Postman

                                        It would be very nice to have option to generate Postman collection directly from Apiary.

                                        http://www.getpostman.com/docs/sharing

                                        19 votes
                                        Vote
                                        Sign in
                                        Check!
                                        (thinking…)
                                        Reset
                                        or sign in with
                                        • facebook
                                        • google
                                          Password icon
                                          I agree to the terms of service
                                          Signed in as (Sign out)
                                          You have left! (?) (thinking…)
                                          under review  ·  Lukas LinhartLukas Linhart responded

                                          That’s a great idea, but I cannot give any ETA now. 3rd party library for apiblueprint → postman would definitely be welcome!

                                        • Make API Blueprint Searchable.

                                          I love blueprints but usings plan old google search doesn't seem to work for them. I suggest you help make the interface somehow better for folks with large API where searching would be required.

                                          4 votes
                                          Vote
                                          Sign in
                                          Check!
                                          (thinking…)
                                          Reset
                                          or sign in with
                                          • facebook
                                          • google
                                            Password icon
                                            I agree to the terms of service
                                            Signed in as (Sign out)
                                            You have left! (?) (thinking…)
                                          ← Previous 1 3 4 5
                                          • Don't see your idea?

                                          General

                                          Feedback and Knowledge Base