Settings API

Connections

The company’s accounts elsewhere, whichever product uses them: GitHub — Cloud builds from it and runs its runners — and AWS, whose SES the mail may leave through and whose bucket Drive may keep its files in.

Base URL https://cloud.yet.com.br/v1 · https://acme.yet.com.br/api/settings

Settings answer at your company’s own address — acme here — and take a key of someone who runs them.

List connections

GET/v1/connections

Each, and whether it is connected.

Request

curl https://cloud.yet.com.br/v1/connections \
  -H "Authorization: Bearer $YET_API_KEY"

Connect with a token

PUT/v1/connections/{kind}

In place of Yet’s GitHub App installation.

Who: Cloud admin

Body

tokenstringrequired: The account’s token.

Request

curl -X PUT https://cloud.yet.com.br/v1/connections/{kind} \
  -H "Authorization: Bearer $YET_API_KEY"

Disconnect

DELETE/v1/connections/{kind}

Builds and runners from it stop.

Who: Cloud admin

Request

curl -X DELETE https://cloud.yet.com.br/v1/connections/{kind} \
  -H "Authorization: Bearer $YET_API_KEY"

Response · 204 No Content

GitHub App install address

GET/v1/connections/github/install

Where a person installs Yet’s GitHub App, to come back to return.

Request

curl https://cloud.yet.com.br/v1/connections/github/install \
  -H "Authorization: Bearer $YET_API_KEY"

List repositories

GET/v1/connections/github/repositories

The company’s repositories Cloud can build.

Request

curl https://cloud.yet.com.br/v1/connections/github/repositories \
  -H "Authorization: Bearer $YET_API_KEY"

Get the AWS account

GET/api/settings/aws

Its region and access key id — never the secret — or null.

Who: Runs the company’s Settings

Request

curl https://acme.yet.com.br/api/settings/aws \
  -H "Authorization: Bearer $YET_API_KEY"

Response · 200

{
  "aws": {
    "region": "us-east-1",
    "access_key_id": "AKIA…"
  }
}

Connect the AWS account

PUT/api/settings/aws

Checked with AWS, sealed, and the company’s domains registered in its SES.

Who: Runs the company’s Settings

Body

regionstringrequired: Its region.
access_key_idstringrequired: The key’s id.
secret_access_keystringrequired: The key’s secret.

Request

curl -X PUT https://acme.yet.com.br/api/settings/aws \
  -H "Authorization: Bearer $YET_API_KEY"

Disconnect it

DELETE/api/settings/aws

The key goes; mail through it stops.

Who: Runs the company’s Settings

Request

curl -X DELETE https://acme.yet.com.br/api/settings/aws \
  -H "Authorization: Bearer $YET_API_KEY"