Show who this connection is

Who this connection is: its own access, the account, authentication, expiry, what it may do.

Says who the connection is: the access the call is made with, the manitu customer account it belongs to, and its rights - the account id (also the customer number), the access id (main or sub access), how the credential authenticated (credential_type, auth_strength) and until when (expires_at); for an API key also its level (app_credential_level: read or write), what it may change without a person's approval in the customer panel and until when (self_approval: level, expires_at) and the ways in it can use now (usable_channel_list). It counts the unread notices manitu left for the access in the customer panel, and the urgent ones among them (manitu_access_notice_listPOST /v1/access/notice/list). Another access of the account, by its access_id, is manitu_account_access_getPOST /v1/account/access/get; the rate limits, manitu_access_rate_limit_getPOST /v1/access/rate-limit/get. No contact or contract data. Changes nothing.

RReadIdempotent
Tool
POST
Try it
readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Says who this connection is: the access, its account, its rights - which manitu customer account it works in, and through which access: the account id (it is also the customer number the account holder knows), the access id (main or sub access), how the connection authenticated, and until when; for an API key also what it may do (app_credential_level: read only, or write), what it may change without asking the user first, and until when (self_approval: level, expires_at), and which ways in it can use (rest, mcp). Call it first when you need to know whose account you act in, before telling the user which account a later answer refers to, or when a change is refused and you need to know whether this connection may change anything at all. Another access of the account, by its access_id: manitu_account_access_getPOST /v1/account/access/get; all of them: manitu_account_access_listPOST /v1/account/access/list. It also counts the unread notices manitu left for this access in the customer panel, and the urgent ones among them (read them with manitu_access_notice_listPOST /v1/access/notice/list). How many calls this access has left: manitu_access_rate_limit_getPOST /v1/access/rate-limit/get. It returns no contact or contract data - no name, no address, no products.

Takes no arguments.

account_idinteger

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

access_idinteger

The access on that account this call is made with.

credential_typestring

What this call was made with.

One of session apikey oauth
auth_strengthstring

How the access authenticated.

One of password tfa token oauth
expires_atstring | null

When the credential ends at the latest (ISO 8601), or null.

pattern ^[^\x00-\x1F\x7F]*$
app_credential_levelstring | null

What an API key may do: read only, or write. What a key may do without the user's approval is set for the key in the customer panel; what needs his approval there waits for him. null for a session.

One of read write null
self_approvalobject

What the key may change without being asked, and until when - set for it by the user in the customer panel; both null without a key.

self_approval.levelstring | null

The higher, the less is asked: client_dialog (the default) - a change that needs the user's yes is answered with approval_required and an approval_token, and goes through as the same call again with it after his yes in the chat; caller_confirmation - such changes go through without that round, the user trusts this key with them; client_click - also what would need a confirmation in a window of his client. Terms and prices are asked for each time, and what needs a person in the customer panel waits there, whatever the key may do. The level that holds now: client_dialog once expires_at has passed; null without a key.

One of client_dialog caller_confirmation client_click null
self_approval.expires_atstring | null

Until when level holds, client_dialog after it; null: without end or without a key.

Format date-time
facadestring | null

The way this call came: rest or mcp; null if not known.

One of rest mcp null
usable_channel_listarray of string

The ways in this credential can use now: rest and mcp for a key; panel for a session - its sign-in to the customer panel, which also covers calls made with the session over REST (a session never works over MCP). A way not listed is closed for it - the user sets the ways in in the customer panel.

noticeobject | null

The notices manitu left for this access in the customer panel (read them with manitu_access_notice_listPOST /v1/access/notice/list); null if they could not be read.

notice.countobject
notice.count.newobject

The unread ones.

notice.count.new.allinteger

All unread notices.

notice.count.new.urgentinteger

Of those, the urgent ones - worth telling the user about once.

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

No fields - send {} or no body.

account_idinteger

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

access_idinteger

The access on that account this call is made with.

credential_typestring

What this call was made with.

One of session apikey oauth
auth_strengthstring

How the access authenticated.

One of password tfa token oauth
expires_atstring | null

When the credential ends at the latest (ISO 8601), or null.

pattern ^[^\x00-\x1F\x7F]*$
app_credential_levelstring | null

What an API key may do: read only, or write. What a key may do without the user's approval is set for the key in the customer panel; what needs his approval there waits for him. null for a session.

One of read write null
self_approvalobject

What the key may change without being asked, and until when - set for it by the user in the customer panel; both null without a key.

self_approval.levelstring | null

The higher, the less is asked: client_dialog (the default) - a change that needs the user's yes is answered with approval_required and an approval_token, and goes through as the same call again with it after his yes in the chat; caller_confirmation - such changes go through without that round, the user trusts this key with them; client_click - also what would need a confirmation in a window of his client. Terms and prices are asked for each time, and what needs a person in the customer panel waits there, whatever the key may do. The level that holds now: client_dialog once expires_at has passed; null without a key.

One of client_dialog caller_confirmation client_click null
self_approval.expires_atstring | null

Until when level holds, client_dialog after it; null: without end or without a key.

Format date-time
facadestring | null

The way this call came: rest or mcp; null if not known.

One of rest mcp null
usable_channel_listarray of string

The ways in this credential can use now: rest and mcp for a key; panel for a session - its sign-in to the customer panel, which also covers calls made with the session over REST (a session never works over MCP). A way not listed is closed for it - the user sets the ways in in the customer panel.

noticeobject | null

The notices manitu left for this access in the customer panel (read them with manitu_access_notice_listPOST /v1/access/notice/list); null if they could not be read.

notice.countobject
notice.count.newobject

The unread ones.

notice.count.new.allinteger

All unread notices.

notice.count.new.urgentinteger

Of those, the urgent ones - worth telling the user about once.

200Success.400The input is wrong, or the request itself (INVALID_INPUT). Each entry names its field and its reason - correct the input and call again.401No credential was presented, or it was not recognised (UNAUTHENTICATED).403The credential is valid, but may not do this (PERMISSION_DENIED). The reason says why - another credential is the way, not a repeat.429Too many calls. The Retry-After header says when to try again.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.
Example