Change the ways into the account

Which ways in the customer allows for the whole account - main access with a session only.

WWriteIdempotentbetaNeeds account

POST

/v1/account/access/seton https://api.manitu.de

Try it

Changes the account. Agents say what will happen and wait for an explicit yes before calling it.

Not offered over MCP - only to programs over REST.

Authentication

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

Request body JSON; unknown fields are refused

access_channel_listarray of stringrequired

The ways in to allow: panel (customer panel), rest (API), mcp (AI agents). The main access keeps the panel either way.

unique true

Response in `data`; the rest of the body as on every call

account_idintegerrequired

The customer account - its id is also its customer number.

channel_listarray of stringrequired

The ways in the customer allows for the whole account: panel (customer panel), rest (API), mcp (AI agents).

is_customizedbooleanrequired

Whether the customer chose the ways in; false: the defaults apply.

locked_channel_listarray of stringrequired

The ways in manitu closed - closed whatever channel_list says.

Statuses

200Success.400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.

POST/v1/account/access/set

Request

curl -X POST 'https://api.manitu.de/v1/account/access/set' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "access_channel_list": [
      "panel"
    ]
  }'

const response = await fetch('https://api.manitu.de/v1/account/access/set', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "access_channel_list": [
      "panel"
    ]
  }),
});
const answer = await response.json();

<?php

$curl = curl_init('https://api.manitu.de/v1/account/access/set');

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{"access_channel_list":["panel"]}',
    CURLOPT_RETURNTRANSFER => true,
]);

$answer = json_decode(curl_exec($curl), true);

import os

import requests

response = requests.request(
    "POST",
    "https://api.manitu.de/v1/account/access/set",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "access_channel_list": [
            "panel",
        ],
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "account_id": 12345,
    "channel_list": [
      "panel"
    ],
    "is_customized": true,
    "locked_channel_list": [
      "panel"
    ]
  }
}

Change the ways into the account

Authentication

Request body JSON; unknown fields are refused

Response in data; the rest of the body as on every call

Statuses

Response in `data`; the rest of the body as on every call