Feat: Create an Organisation on Gogs (Fly.io) via REST API

[nelsonic]

My reading of the Org API: https://github.com/gogs/docs-api/tree/master/Organizations
is that there is no way to create an Org, e.g:

PUT /orgs/:orgname

or

POST /orgs/:orgname

So going to try and use the "Edit" endpoint:
https://github.com/gogs/docs-api/tree/master/Organizations#edit-an-organization

PATCH /orgs/:org

If that fails, I will be opening an issue on: https://github.com/gogs/docs-api/issues ⏳
And I might end up writing some Go code today. 💭

Wish me luck! 🤞

[nelsonic]

Sadly, there doesn't appear to be an org creation endpoint ...
Issue created: gogs/docs-api#33

[nelsonic]

We are going to get around this by simply doing "org_name-repo_name in the short term.
But it would be great to be able to programatically create organisations for GitHub Backup to work. 💭

[nelsonic]

Parking this code here for now. Sadly it doesn't work ...

  @doc """
  `patch/1` accepts `url`; 
  the `url` of the API endpoint to create the `org`.
  """
  @spec patch(String.t(), map) :: {:ok, map} | {:error, any}
  def patch(url, params) do
    body = Jason.encode!(params)
    headers = [
      {"Accept", "application/json"},
      {"Authorization", "token #{@access_token}"},
      {"Content-Type", "application/json"}
    ]
    inject_poison().patch(url, body, headers)
    |> parse_body_response()
  end

  @doc """
  `org_create/1` accepts 1 argument: `org_name` to be crated.
  """
  def org_create(org_name) do
    url = @api_base_url <> "orgs/#{org_name}?token=#{@access_token}"
    # IO.inspect(url, label: "remote_repo_delete url")
    params = %{
      full_name: org_name,
      description: org_name,
    }
    patch(url, params)
  end

[nelsonic]

Dang ... 🤦‍♂️
Gitea allows POST /orgs to create an Org: https://try.gitea.io/api/swagger#/

For reference, the Gogs API docs for Organizations at the time of writing:
https://github.com/gogs/docs-api/tree/9740f402bd1e28892fe544eaac83ee016a7202df/Organizations

Were last updated Dec 17, 2018 ...

I didn't see this as a "Red flag" at the time because I didn't think we would need all the Org-related APIs ...
But I was wrong. Not only would the better Orgs API be useful it would be transformative in our particular use-case.

[nelsonic]

GOTO: dwyl/gitea#7