Every Kallithea user automatically receives an API key, which they can

view under "My Account". On this page, API keys can also be revoked, and

additional API keys can be generated.

API access

----------

Clients must send JSON encoded JSON-RPC requests::

    {

        "api_key": "<api_key>",

        "method": "<method_name>",

        "args": {"<arg_key>": "<arg_val>"}

    }

For example, to pull to a local "CPython" mirror using curl::

    curl https://kallithea.example.com/_admin/api -X POST -H 'content-type:text/plain' \

        --data-binary '{"id":1,"api_key":"xe7cdb2v278e4evbdf5vs04v832v0efvcbcve4a3","method":"pull","args":{"repoid":"CPython"}}'

In general, provide

 - *id*, a value of any type, can be used to match the response with the request that it is replying to.

              "msg" : "created new user group `<groupname>`",

              "users_group" : {

                     "users_group_id" : "<id>",

                     "group_name" :     "<groupname>",

                     "active" :         "<bool>"

               }

             }

    error : null

add_user_to_user_group

^^^^^^^^^^^^^^^^^^^^^^

``false``.

This command can only be executed using the api_key of a user with admin rights.

INPUT::

    id : <id_for_response>

    api_key : "<api_key>"

    method :  "add_user_user_group"

    args :    {

                "usersgroupid" : "<user group id or name>",

                "userid" : "<user_id or username>"

              }