connectProviderLogin

PUT

/api/v1/me/provider-logins/{provider}

Connect (or replace) your login for a harness. The credential is checked, stored encrypted and never shown again. Only from a browser session, not with an API token.

curl --request PUT \
  --url '<base-url>/api/v1/me/provider-logins/<provider>' \
  --header 'Content-Type: application/json' \
  --cookie 'agenthold_session=<agenthold_session>' \
  --data '
{
  "kind": "string",
  "credential": "string"
}
'

const url = '<base-url>/api/v1/me/provider-logins/<provider>';
const options = {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    cookie: 'agenthold_session=<agenthold_session>'
  },
  body: JSON.stringify({kind: 'string', credential: 'string'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "<base-url>/api/v1/me/provider-logins/<provider>"

payload = {
    "kind": "string",
    "credential": "string"
}
headers = {
    "cookie": "agenthold_session=<agenthold_session>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

Response example

{
  "provider": "string",
  "name": "string",
  "kinds": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "command": "string",
      "inputLabel": "string",
      "multiline": true
    }
  ],
  "login": {
    "kind": "string",
    "label": "string",
    "status": "ok",
    "statusMessage": "string",
    "expiresAt": "2019-08-24T14:15:22Z",
    "connectedAt": "2019-08-24T14:15:22Z",
    "lastUsedAt": "2019-08-24T14:15:22Z"
  },
  "agents": [
    {
      "id": "string",
      "name": "string",
      "workspaceId": "string"
    }
  ]
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

Authorization

session
optional
API key in cookie

token
optional
HTTP Bearer
Authorization: Bearer <token>

Path parameters

provider
string
required
Harness id (claude-code, codex).

Request body JSON required

kind
string
required
credential
string
required
The token, key or file contents. Never returned.

maxLength: 65536 · minLength: 1

Returns

200

Connected.

JSON

provider
string
required
Harness id.
name
string
required
kinds
array of
object
required
- id
  string
  required
- name
  string
  required
- description
  string
  required
- inputLabel
  string
  required
- multiline
  boolean
  required
- command
  optional
  string
  What to run on your own computer to get the credential.
}
agents
array of
object
required
Agents with this harness that use your logins.
- id
  string
  required
- name
  string
  required
- workspaceId
  string
  required
}
login
optional
object
- kind
  string
  required
- label
  string
  required
  Describes the login without revealing it.
- status
  ok
  or
  error
  required
- statusMessage
  string
  required
- connectedAt
  string
  required
  format: date-time
- expiresAt
  optional
  string
  format: date-time
- lastUsedAt
  optional
  string
  format: date-time
}

400

Error.

JSON

error
string
required

403

Error.

JSON

error
string
required

404

Error.

JSON

error
string
required