Glossary

enum

An enum is a fixed list of allowed values in a schema. A value outside the list is refused before a tool or endpoint runs.

Updated November 15, 2026

Standard
JSON Schema
Also called
enumerated values

At OneLifeVibe

Related terms

What it means

An enum, short for enumerated values, is a fixed list of allowed values in a schema. The argument can hold only one of the listed values. It is a closed set, not a hint. If the list allows three values, a fourth value fails validation even if it looks reasonable. Enums keep inputs predictable and stop a call from reaching a tool or endpoint with a value the other side does not handle.

You will see enums in tool input schemas, where they describe the exact choices an argument accepts. A schema may also set a type, a range or a pattern. The enum adds the allowed set on top.

How it works

Validation runs at the boundary. The schema is read, then the incoming arguments are checked against it. A declared argument with a value in the enum passes. A value outside the enum fails before the tool or endpoint runs. The same check catches undeclared arguments, missing required arguments, wrong types and values outside a range or pattern. If everything passes, the call proceeds. If not, the request stops with a validation error, so a bad value cannot become a partial call.

How OneLifeVibe uses it

When you call POST /api/platform/v1/tools/:name, OneLifeVibe validates the arguments before anything is called. An undeclared argument, a missing required argument, a wrong type, or a value outside its range, enum or pattern is refused. The Platform API returns 400 invalid_arguments. Only declared arguments are forwarded to the website. That means a typo in a value or an extra field does not reach the website. Fix the request to match the tool input schema, then send it again.

Common mistakes

The main mistake is treating an enum as a suggestion. Sending a near match or a value you made up fails if it is not in the list. Another is adding an argument the schema does not declare. That is refused too, even if you expected the tool to ignore it. A missing required argument or a number sent as a string fails the same check. Read the 400 invalid_arguments response, compare the arguments with the tool input schema, and correct the value, type or field. Retrying the same request will produce the same refusal.

Questions

What does 400 invalid_arguments mean for an enum value?

It means the request failed validation before the tool or endpoint ran. The argument was undeclared, missing, the wrong type, or outside its range, enum or pattern. For an enum, check that the value is in the tool input schema's list.

Does OneLifeVibe forward extra arguments to a website?

No. An argument the schema does not declare is refused with 400 invalid_arguments. Only declared arguments are forwarded to the website.

See it working. The OneLifeVibe connector and Platform API put these pieces together.

Get a free key Read the docs

Written from the OneLifeVibe tool registry and platform configuration, and checked automatically before publishing. Something wrong? Tell us.