AI Ability · write

nibwp/forms-manage

Create or update forms data in a single typed call — fields, status and relationships set together, with force-draft so nothing goes live unreviewed.

Overview

What forms-manage does

nibwp/forms-manage is a write ability: it creates or updates records, validates every argument against a schema, honors force-draft, and returns the affected ID so agents can chain the next step.

Parameters

NameTypeRequiredDescription
idstringoptionalTarget object ID when updating an existing item.
dataobjectrequiredThe fields to create or update.
statusenumoptionaldraft · publish · pending. Force-draft can override.
metaobjectoptionalCustom field key/value pairs to set.

Example call

tool: "nibwp/forms-manage" args: { data: { title: "Example" }, status: "draft" }
200 { id: 512, status: "draft" }

What it can do

  • Create or update records in one typed call
  • Set fields, status and taxonomies together
  • Honor force-draft so nothing publishes unreviewed
  • Return the affected ID and link for chaining
Safety

Powerful, but governed

Force draft

Make every AI write a draft until a human approves it.

Audited

Each call is logged with status, latency, user and IP.

Rate limited

Per-token throttling stops runaway bulk operations.

Scoped tokens

Grant this tool only to the agents that should have it.

Related

Abilities that pair with it

FAQ

This ability, answered

What does it return?

A structured result with the affected ID, status and permalink, ready to chain.

Is it logged?

Always — every call appears in the audit log with timing and the calling user.

Can I restrict it?

Yes — enable or disable it per token and restrict by category, post type, rate and IP.

Does it validate input?

Yes — every argument is checked against the JSON schema before anything runs.

See forms-manage run on a live site.

Book a demo and watch an agent call this ability through NibWP.