PUT
/v1/agents/{agentKey}

Creates the agent's setup, or replaces it. This is a full replacement rather than a merge, so send every field you want kept. It changes the setup your team sees in the app, and the next run uses it.

Authorization

apiKey
headerAuthorizationBearer <token>

API key for authenticating protected endpoints. Pass as Bearer token in Authorization header.

Path Parameters

agentKey*string

Which agent, such as changelog

Request Body

Body

application/json
  1. body
repository?string

A public GitHub repository as owner/name. A public one needs no connection.

Match^[\w.-]+\/[\w.-]+$
values?

Settings keyed by the field keys from GET /v1/agents

deliverables?array<string>

Which deliverables to make. A required one is always included.

Response Body

The agent as it now stands

application/json
  1. response
key*string
name*string
summary*string
fields*array<>

What this agent can be configured with

deliverables*array<>
installed*boolean
setup*|

Null until it is set up

curl -X PUT "https://example.com/v1/agents/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "key": "string",  "name": "string",  "summary": "string",  "fields": [    {      "key": "string",      "label": "string",      "type": "string",      "required": true,      "helperText": "string"    }  ],  "deliverables": [    {      "key": "string",      "label": "string",      "required": true    }  ],  "installed": true,  "setup": {    "repository": "string",    "values": {      "property1": null,      "property2": null    },    "deliverables": [      "string"    ]  }}