List pending approvals

The calls kept for the user's approval in the customer panel - waiting ones and recent ones.

Lists the calls of the calling access that wait for approval in the customer panel, and those of the last 7 days, newest first - each with its status, what it is about (approval.elements) and until when it waits. A call answered with approval_required is one of them. It approves nothing: only the user does, signed in to the customer panel. One of them: manitu_approval_getPOST /v1/approval/get. Changes nothing.

RReadIdempotent
Tool
manitu_approval_liston https://mcp.manitu.de/mcp
POST
/v1/approval/liston https://api.manitu.de
Try it
readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Lists the calls of this access in the manitu customer account that wait for the user's approval in the customer panel, and those of the last 7 days, newest first - each with its status, what it is about (approval.elements) and until when it waits. A call answered with approval_required and a pending_action is one of them. Nothing here approves anything: only the user does, signed in to the customer panel. Use it to tell the user what waits, or to find a pending_action_id again.

status_listarray of any

Only these statuses, e.g. ["pending"]; left out: all.

unique true
scopestring

own (default): this access's; account: those of every access of the account - for the main access, any other gets its own.

One of own account
page_sizeinteger

How many entries per page, default 100.

min 1max 500
page_tokenstring

next_page_token of the previous page - with the same filters.

pattern ^[^\x00-\x1F\x7F]*$
pending_action_listarray of object
pending_action_list[].pending_action_idstring

The id, not guessable, bound to the account and the access that made it.

min length 1max length 255
pending_action_list[].statusany

pending: waits for the person; approved: approved, not carried out yet; executed: carried out, result is its answer; failed: carried out, it failed - result says how; unverified: carried out, whether it took effect is not known; declined: the person said no; expired: nobody decided in time; cancelled: the caller withdrew it.

One of pending approved executed failed unverified declined expired cancelled
pending_action_list[].operation_idstring | nulloptional

The operation of the route export it carries out; null where the backend does not say.

pattern ^[a-z][a-z0-9]*(_[a-z][a-z0-9]*)*$
pending_action_list[].created_atstring
Format date-time
pending_action_list[].expires_atstring

Until when it waits for the person.

Format date-time
pending_action_list[].decided_atstring | nulloptional

When it was approved, declined, cancelled or expired; null while it is pending.

Format date-time
pending_action_list[].decided_viastring | nulloptional

Where it was decided: panel - the backend's own user interface; api - a call of the backend (cancelled); an open set, lower_snake_case. null while it is pending.

pattern ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
pending_action_list[].approvalobjectoptional

The approval it waits for - the ways while it is pending, none once it is decided. Not under approval_required, where it stands beside it as params.approval.

pending_action_list[].approval.required_levelany

The level of approval the call needs (components/1/approval-levels.json). A reader compares ranks, never names.

One of none client_dialog caller_confirmation client_click signed_in_person fresh_second_factor
pending_action_list[].approval.concernsarray of any

What the approval is about, at least one, each once: terms (a declaration on terms), price (it costs money), contract (a contract is concluded, changed or ended), irreversible (what is deleted or overwritten cannot be brought back), downtime (a service is unreachable for a while), service_access (someone gets access to a service or its data), account_access (who can access the account changes), ownership (something leaves the account or changes its owner), disclosure (data goes to a party outside the account). A closed set; a new value comes with a new release of the spec. An approval given in advance never covers terms or price.

min items 1unique true
pending_action_list[].approval.raised_byarray of any

Why the level is above what the operation needs at least, where it is: consumer_price (it costs a consumer money), outside_content (this credential read content from the internet shortly before), account_rule (the account has it so), input_content (what the call sets runs code or sends data out of the account), input_field (the call sends a field the operation asks more for, approval_by_field of the route export). Empty where the level is the operation's own. A closed set; a new value comes with a new release of the spec.

unique true
pending_action_list[].approval.elementsarray of object

What the approval is about, each shown as it is - may be empty.

pending_action_list[].approval.elements[].kindany

document, text, declaration - what the person agrees to; subject, change, consequence - what is done and what follows; price - what it costs.

One of document text price declaration subject change consequence
pending_action_list[].approval.elements[].codestring | nulloptional

What it is, as a code - required by a reader for document, text and declaration, which are logged by it.

pattern ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].titlestring | nulloptional

Its title, in language.

pending_action_list[].approval.elements[].languagestring | nulloptional

The language of title and text - the binding wording.

pattern ^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$
pending_action_list[].approval.elements[].urlstring | nulloptional

Where the document is; a document only.

pending_action_list[].approval.elements[].textstring | nulloptional

The text, shown as it is: of a text, a declaration (a sentence in the first person) or a consequence.

pending_action_list[].approval.elements[].labelstring | nulloptional

Of a subject or a change: what it is about (Server, Package).

pending_action_list[].approval.elements[].valuestring | nulloptional

Of a subject: which one (vs-1002).

pending_action_list[].approval.elements[].beforestring | nulloptional

Of a change: the value now.

pending_action_list[].approval.elements[].afterstring | nulloptional

Of a change: the value after.

pending_action_list[].approval.elements[].priceobjectoptional

Of a price: what it costs.

pending_action_list[].approval.elements[].price.chargesarray of object

The charges, at least one - e.g. a prorated amount now and the new plan per year.

min items 1
pending_action_list[].approval.elements[].price.charges[].codestring

What the charge is for, a lower_snake_case code of the backend, e.g. domain_fee, plan_fee - the reader translates it.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].billingobject

How the charge is billed.

pending_action_list[].approval.elements[].price.charges[].billing.kindstring

one_time: charged once; recurring: charged per period; usage: charged by use, per unit, settled per period. An open set: a reader that does not know a kind shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].billing.periodobjectoptional

The billing period - with recurring and usage, not with one_time.

pending_action_list[].approval.elements[].price.charges[].billing.period.unitstring

hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].billing.period.lengthinteger

How many of the unit, at least 1.

min 1
pending_action_list[].approval.elements[].price.charges[].billing.perobjectoptional

The unit a usage charge counts, e.g. 1 hour - with usage, and only there.

pending_action_list[].approval.elements[].price.charges[].billing.per.unitstring

hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].billing.per.lengthinteger

How many of the unit, at least 1.

min 1
pending_action_list[].approval.elements[].price.charges[].usageobjectoptional

What bounds a usage charge - with usage only.

pending_action_list[].approval.elements[].price.charges[].usage.capanyoptional

The most the charge comes to per billing period - binding, with the digits of the currency.

pending_action_list[].approval.elements[].price.charges[].usage.includedobjectoptional

How much of the unit is in the price before the rate applies - in the unit of billing.per.

pending_action_list[].approval.elements[].price.charges[].usage.included.unitstring

hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].usage.included.lengthinteger

How many of the unit, at least 1.

min 1
pending_action_list[].approval.elements[].price.charges[].conditionstringoptional

When the charge is due at all, a lower_snake_case code: on_success - only when what it is for succeeds. An open set; not there: always.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].service_periodobjectoptional

The days the charge covers, the first and the last both included - e.g. the rest of a period on a change of plan.

pending_action_list[].approval.elements[].price.charges[].service_period.fromstring

The first day.

Format date
pending_action_list[].approval.elements[].price.charges[].service_period.tostring

The last day.

Format date
pending_action_list[].approval.elements[].price.charges[].phasesarray of object

What the charge amounts to, phase by phase, in order: each begins where the one before it ends. A one_time charge has one phase, without cycles; the last phase of a recurring or usage charge has cycles null, and only that one.

min items 1
pending_action_list[].approval.elements[].price.charges[].phases[].kindstring

trial, promo or regular. An open set: a reader that does not know a kind shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].phases[].cyclesinteger | nulloptional

How many billing periods the phase lasts; null: without end. Not there with one_time.

min 1
pending_action_list[].approval.elements[].price.charges[].phases[].periodobjectoptional

The billing period of this phase, where it differs from billing.period - e.g. three months free of a yearly plan.

pending_action_list[].approval.elements[].price.charges[].phases[].period.unitstring

hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].phases[].period.lengthinteger

How many of the unit, at least 1.

min 1
pending_action_list[].approval.elements[].price.charges[].phases[].amountany

What is charged per period of the phase - never per month unless the period is one. With usage: per unit of billing.per, and it may have more digits than the currency.

pending_action_list[].approval.elements[].price.summarystringoptional

The whole price in one sentence, in the language of the answer, as the backend writes it - what a reader shows where it does not know a code. Never instead of the charges.

min length 1max length 1000
pending_action_list[].approval.waysarray of object

How it can be given, the best first; the last is the fallback. A reader takes the first it can use and passes over a kind it does not know. Empty once a kept call is decided.

pending_action_list[].approval.ways[].kindstring

call_again - the caller sends the same call again with token in the input field parameter, after an explicit yes of the person; panel - a person approves it in the backend's own user interface, at url. An open set, lower_snake_case.

pattern ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
pending_action_list[].approval.ways[].tokenstringoptional

Of call_again: what to send with the same call again - bound to this call and its input.

min length 1max length 255
pending_action_list[].approval.ways[].parameterstringoptional

Of call_again: the input field the token goes in - a protocol parameter of the operation, approval_token.

pattern ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
pending_action_list[].approval.ways[].urlstringoptional

Of panel: the page where the person approves it. A pointer only - the person signs in there all the same.

min length 1
pending_action_list[].approval.expires_atstring | null

Until when the approval can be given; null where the backend does not say.

Format date-time
pending_action_list[].resultobject | nulloptional

The structured answer of the operation it carried out, once executed, failed or unverified; null until then.

pending_action_list[].created_byobject

Who made it - for the main access, which sees the calls of every access of the account.

pending_action_list[].created_by.account_user_idinteger

The access that made it.

pending_action_list[].created_by.typestring

primary: the main access; secondary: a sub access.

One of primary secondary ngcobalt_site_mail_user
pending_action_list[].created_by.descriptionstring | null

The description written for it, null if nothing - not its name or user name.

total_countinteger

How many entries match, on all pages together.

next_page_tokenstring | null

Pass as page_token for the next page; null on the last.

pattern ^[^\x00-\x1F\x7F]*$

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

status_listarray of any

Only these statuses, e.g. ["pending"]; left out: all.

unique true
scopestring

own (default): this access's; account: those of every access of the account - for the main access, any other gets its own.

One of own account
page_sizeinteger

How many entries per page, default 100.

min 1max 500
page_tokenstring

next_page_token of the previous page - with the same filters.

pattern ^[^\x00-\x1F\x7F]*$
pending_action_listarray of object
pending_action_list[].pending_action_idstring

The id, not guessable, bound to the account and the access that made it.

min length 1max length 255
pending_action_list[].statusany

pending: waits for the person; approved: approved, not carried out yet; executed: carried out, result is its answer; failed: carried out, it failed - result says how; unverified: carried out, whether it took effect is not known; declined: the person said no; expired: nobody decided in time; cancelled: the caller withdrew it.

One of pending approved executed failed unverified declined expired cancelled
pending_action_list[].operation_idstring | nulloptional

The operation of the route export it carries out; null where the backend does not say.

pattern ^[a-z][a-z0-9]*(_[a-z][a-z0-9]*)*$
pending_action_list[].created_atstring
Format date-time
pending_action_list[].expires_atstring

Until when it waits for the person.

Format date-time
pending_action_list[].decided_atstring | nulloptional

When it was approved, declined, cancelled or expired; null while it is pending.

Format date-time
pending_action_list[].decided_viastring | nulloptional

Where it was decided: panel - the backend's own user interface; api - a call of the backend (cancelled); an open set, lower_snake_case. null while it is pending.

pattern ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
pending_action_list[].approvalobjectoptional

The approval it waits for - the ways while it is pending, none once it is decided. Not under approval_required, where it stands beside it as params.approval.

pending_action_list[].approval.required_levelany

The level of approval the call needs (components/1/approval-levels.json). A reader compares ranks, never names.

One of none client_dialog caller_confirmation client_click signed_in_person fresh_second_factor
pending_action_list[].approval.concernsarray of any

What the approval is about, at least one, each once: terms (a declaration on terms), price (it costs money), contract (a contract is concluded, changed or ended), irreversible (what is deleted or overwritten cannot be brought back), downtime (a service is unreachable for a while), service_access (someone gets access to a service or its data), account_access (who can access the account changes), ownership (something leaves the account or changes its owner), disclosure (data goes to a party outside the account). A closed set; a new value comes with a new release of the spec. An approval given in advance never covers terms or price.

min items 1unique true
pending_action_list[].approval.raised_byarray of any

Why the level is above what the operation needs at least, where it is: consumer_price (it costs a consumer money), outside_content (this credential read content from the internet shortly before), account_rule (the account has it so), input_content (what the call sets runs code or sends data out of the account), input_field (the call sends a field the operation asks more for, approval_by_field of the route export). Empty where the level is the operation's own. A closed set; a new value comes with a new release of the spec.

unique true
pending_action_list[].approval.elementsarray of object

What the approval is about, each shown as it is - may be empty.

pending_action_list[].approval.elements[].kindany

document, text, declaration - what the person agrees to; subject, change, consequence - what is done and what follows; price - what it costs.

One of document text price declaration subject change consequence
pending_action_list[].approval.elements[].codestring | nulloptional

What it is, as a code - required by a reader for document, text and declaration, which are logged by it.

pattern ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].titlestring | nulloptional

Its title, in language.

pending_action_list[].approval.elements[].languagestring | nulloptional

The language of title and text - the binding wording.

pattern ^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$
pending_action_list[].approval.elements[].urlstring | nulloptional

Where the document is; a document only.

pending_action_list[].approval.elements[].textstring | nulloptional

The text, shown as it is: of a text, a declaration (a sentence in the first person) or a consequence.

pending_action_list[].approval.elements[].labelstring | nulloptional

Of a subject or a change: what it is about (Server, Package).

pending_action_list[].approval.elements[].valuestring | nulloptional

Of a subject: which one (vs-1002).

pending_action_list[].approval.elements[].beforestring | nulloptional

Of a change: the value now.

pending_action_list[].approval.elements[].afterstring | nulloptional

Of a change: the value after.

pending_action_list[].approval.elements[].priceobjectoptional

Of a price: what it costs.

pending_action_list[].approval.elements[].price.chargesarray of object

The charges, at least one - e.g. a prorated amount now and the new plan per year.

min items 1
pending_action_list[].approval.elements[].price.charges[].codestring

What the charge is for, a lower_snake_case code of the backend, e.g. domain_fee, plan_fee - the reader translates it.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].billingobject

How the charge is billed.

pending_action_list[].approval.elements[].price.charges[].billing.kindstring

one_time: charged once; recurring: charged per period; usage: charged by use, per unit, settled per period. An open set: a reader that does not know a kind shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].billing.periodobjectoptional

The billing period - with recurring and usage, not with one_time.

pending_action_list[].approval.elements[].price.charges[].billing.period.unitstring

hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].billing.period.lengthinteger

How many of the unit, at least 1.

min 1
pending_action_list[].approval.elements[].price.charges[].billing.perobjectoptional

The unit a usage charge counts, e.g. 1 hour - with usage, and only there.

pending_action_list[].approval.elements[].price.charges[].billing.per.unitstring

hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].billing.per.lengthinteger

How many of the unit, at least 1.

min 1
pending_action_list[].approval.elements[].price.charges[].usageobjectoptional

What bounds a usage charge - with usage only.

pending_action_list[].approval.elements[].price.charges[].usage.capanyoptional

The most the charge comes to per billing period - binding, with the digits of the currency.

pending_action_list[].approval.elements[].price.charges[].usage.includedobjectoptional

How much of the unit is in the price before the rate applies - in the unit of billing.per.

pending_action_list[].approval.elements[].price.charges[].usage.included.unitstring

hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].usage.included.lengthinteger

How many of the unit, at least 1.

min 1
pending_action_list[].approval.elements[].price.charges[].conditionstringoptional

When the charge is due at all, a lower_snake_case code: on_success - only when what it is for succeeds. An open set; not there: always.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].service_periodobjectoptional

The days the charge covers, the first and the last both included - e.g. the rest of a period on a change of plan.

pending_action_list[].approval.elements[].price.charges[].service_period.fromstring

The first day.

Format date
pending_action_list[].approval.elements[].price.charges[].service_period.tostring

The last day.

Format date
pending_action_list[].approval.elements[].price.charges[].phasesarray of object

What the charge amounts to, phase by phase, in order: each begins where the one before it ends. A one_time charge has one phase, without cycles; the last phase of a recurring or usage charge has cycles null, and only that one.

min items 1
pending_action_list[].approval.elements[].price.charges[].phases[].kindstring

trial, promo or regular. An open set: a reader that does not know a kind shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].phases[].cyclesinteger | nulloptional

How many billing periods the phase lasts; null: without end. Not there with one_time.

min 1
pending_action_list[].approval.elements[].price.charges[].phases[].periodobjectoptional

The billing period of this phase, where it differs from billing.period - e.g. three months free of a yearly plan.

pending_action_list[].approval.elements[].price.charges[].phases[].period.unitstring

hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary.

pattern ^[a-z0-9]+(_[a-z0-9]+)*$
pending_action_list[].approval.elements[].price.charges[].phases[].period.lengthinteger

How many of the unit, at least 1.

min 1
pending_action_list[].approval.elements[].price.charges[].phases[].amountany

What is charged per period of the phase - never per month unless the period is one. With usage: per unit of billing.per, and it may have more digits than the currency.

pending_action_list[].approval.elements[].price.summarystringoptional

The whole price in one sentence, in the language of the answer, as the backend writes it - what a reader shows where it does not know a code. Never instead of the charges.

min length 1max length 1000
pending_action_list[].approval.waysarray of object

How it can be given, the best first; the last is the fallback. A reader takes the first it can use and passes over a kind it does not know. Empty once a kept call is decided.

pending_action_list[].approval.ways[].kindstring

call_again - the caller sends the same call again with token in the input field parameter, after an explicit yes of the person; panel - a person approves it in the backend's own user interface, at url. An open set, lower_snake_case.

pattern ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
pending_action_list[].approval.ways[].tokenstringoptional

Of call_again: what to send with the same call again - bound to this call and its input.

min length 1max length 255
pending_action_list[].approval.ways[].parameterstringoptional

Of call_again: the input field the token goes in - a protocol parameter of the operation, approval_token.

pattern ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
pending_action_list[].approval.ways[].urlstringoptional

Of panel: the page where the person approves it. A pointer only - the person signs in there all the same.

min length 1
pending_action_list[].approval.expires_atstring | null

Until when the approval can be given; null where the backend does not say.

Format date-time
pending_action_list[].resultobject | nulloptional

The structured answer of the operation it carried out, once executed, failed or unverified; null until then.

pending_action_list[].created_byobject

Who made it - for the main access, which sees the calls of every access of the account.

pending_action_list[].created_by.account_user_idinteger

The access that made it.

pending_action_list[].created_by.typestring

primary: the main access; secondary: a sub access.

One of primary secondary ngcobalt_site_mail_user
pending_action_list[].created_by.descriptionstring | null

The description written for it, null if nothing - not its name or user name.

total_countinteger

How many entries match, on all pages together.

next_page_tokenstring | null

Pass as page_token for the next page; null on the last.

pattern ^[^\x00-\x1F\x7F]*$
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