Creating Listeners, launchers via the Covenant API

[archmangler]

I'm working on automating a covenant deployment via a pipeline and would like to complete the following operations via the API only:

• listener creation
• launcher creation and download

Since the Swagger endpoint doesn't seem to be available, and the Covnant API documentation is rather sparse, could I have some curl-based examples for excercising preferably all covenant configuration and execution operations and at minimum, all configuration operations ?

TIA!

Notes:

As an example, I'm trying to create a Listener via the API as follows, using discovered information about the listener api:

curl -v -k -X POST \
--header 'Content-Type: application/json-patch+json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJBZG1pblVzZXIiLCJqdGkiOiIyMGFjZmY4NC0wMmUxLTc4MzgtNzRlMy0yMjk1MWU2NjE2ZjUiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6Ijc3MzA3NDM0LWIxYmItNDE2Mi1hZmYzLWEyMTkyM2NkNDNkOCIsImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vd3MvMjAwOC8wNi9pZGVudGl0eS9jbGFpbXMvcm9sZSI6WyJBZG1pbmlzdHJhdG9yIiwiVXNlciJdLCJleHAiOjE2NTE5ODM0MjcsImlzcyI6IkNvdmVuYW50IiwiYXVkIjoiQ292ZW5hbnQifQ.Lgz-BwY-vVYAyzMNE2EyLMSUzV1es12YSq-5XZNxTKg' \
-d '{"sslCertificate":null,"sslCertificatePassword":"CovenantDev","sslCertHash":"","connectAddresses":["172.17.0.3"],"urls":["http://172.17.0.3:80"],"useSSL": false,"name": "crap2","description": "Listens on HTTP protocol.","bindAddress": "0.0.0.0","bindPort":80,"connectPort":80,"profile":{"httpUrls":["/en-us/index.html","/en-us/docs.html","/en-us/test.html"],"covenantUrl": "https://localhost:7443"}' \
 https://127.0.0.1:7443/api/listeners)

However, this does not work out, and there is no way of identifying what fields are needed based on the error output:

Note: Unnecessary use of -X or --request, POST is already inferred.
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0*   Trying 127.0.0.1:7443...
* Connected to 127.0.0.1 (127.0.0.1) port 7443 (#0)
* ALPN, offering http/1.1
* successfully set certificate verify locations:
*  CAfile: /opt/local/share/curl/curl-ca-bundle.crt
*  CApath: none
} [5 bytes data]
* TLSv1.3 (OUT), TLS handshake, Client hello (1):
} [512 bytes data]
* TLSv1.3 (IN), TLS handshake, Server hello (2):
{ [108 bytes data]
* TLSv1.2 (IN), TLS handshake, Certificate (11):
{ [748 bytes data]
* TLSv1.2 (IN), TLS handshake, Server key exchange (12):
{ [300 bytes data]
* TLSv1.2 (IN), TLS handshake, Server finished (14):
{ [4 bytes data]
* TLSv1.2 (OUT), TLS handshake, Client key exchange (16):
} [37 bytes data]
* TLSv1.2 (OUT), TLS change cipher, Change cipher spec (1):
} [1 bytes data]
* TLSv1.2 (OUT), TLS handshake, Finished (20):
} [16 bytes data]
* TLSv1.2 (IN), TLS handshake, Finished (20):
{ [16 bytes data]
* SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384
* ALPN, server accepted to use http/1.1
* Server certificate:
*  subject: CN=Covenant
*  start date: Jan 27 03:36:38 2022 GMT
*  expire date: Jan 26 03:36:38 2032 GMT
*  issuer: CN=Covenant
*  SSL certificate verify result: self signed certificate (18), continuing anyway.
} [5 bytes data]
> POST /api/listeners HTTP/1.1
> Host: 127.0.0.1:7443
> User-Agent: curl/7.73.0
> Content-Type: application/json-patch+json
> Accept: application/json
> Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJBZG1pblVzZXIiLCJqdGkiOiIyMGFjZmY4NC0wMmUxLTc4MzgtNzRlMy0yMjk1MWU2NjE2ZjUiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6Ijc3MzA3NDM0LWIxYmItNDE2Mi1hZmYzLWEyMTkyM2NkNDNkOCIsImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vd3MvMjAwOC8wNi9pZGVudGl0eS9jbGFpbXMvcm9sZSI6WyJBZG1pbmlzdHJhdG9yIiwiVXNlciJdLCJleHAiOjE2NTE5ODM0MjcsImlzcyI6IkNvdmVuYW50IiwiYXVkIjoiQ292ZW5hbnQifQ.Lgz-BwY-vVYAyzMNE2EyLMSUzV1es12YSq-5XZNxTKg
> Content-Length: 398
> 
} [398 bytes data]
* upload completely sent off: 398 out of 398 bytes
{ [5 bytes data]
* Mark bundle as not supporting multiuse
< HTTP/1.1 400 Bad Request
< Date: Fri, 28 Jan 2022 06:24:53 GMT
< Server: Kestrel
< Content-Length: 0
<