Publishing

CMS delivery and revisions, public forms, content dispatch.

Start with: cms_configure, cms_publish, forms_create, forms_submissions, cms_revisions.

29 operations. Discover them from an agent with agentdb_capabilities {"category": "publishing"}.

#`cms_configure`

stable added in 1.0.0-rc.6 changes data

Make an object a CMS content type (or change its settings): status/slug/locale fields, the ONLY fields the public delivery API shows (public_fields), delivery off | token (default) | public, CORS origins, cache seconds. Install {template: "cms"} first for pages and posts. Nothing is public until you do this.

MCP tool: cms_configure
REST: POST /v1/workspaces/{ws}/cms/types scope schema:write
CLI: agentdb cms configure

Arguments

Argument	Type	Required	Description
`object`	`string`	yes	Object type name, e.g. contact.
`status_field`	`string`		string, default "status"
`published_status`	`string`		string, 1–64 characters, default "published"
`slug_field`	`string`		string, default "slug"
`locale_field`	`string \| null`		string \| null, default null
`translation_relationship`	`string \| null`		string \| null, default null
`public_fields`	`string[]`	yes	Fields the public content API may return. (max 100 items)
`delivery`	`"off" \| "token" \| "public"`		string, one of: off, token, public, default "token"
`allowed_origins`	`string[] \| null`		string[] \| null, default null
`cache_seconds`	`integer`		integer, 0–86400, default 60
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_configure",
  "arguments": {
    "object": "cms_post",
    "public_fields": [
      "title",
      "slug",
      "body"
    ],
    "delivery": "token"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_configure",
    "arguments": {
      "object": "cms_post",
      "public_fields": [
        "title",
        "slug",
        "body"
      ],
      "delivery": "token"
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/cms/types" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"object":"cms_post","public_fields":["title","slug","body"],"delivery":"token"}'

CLI

agentdb cms configure [options]

#`cms_diff`

stable added in 1.0.0-rc.6 read-only

Field-by-field diff between two revisions (Markdown bodies line by line); to defaults to the current version.

MCP tool: cms_diff
REST: GET /v1/workspaces/{ws}/records/{record}/diff scope records:read
CLI: agentdb cms diff

Arguments

Argument	Type	Required	Description
`from`	`integer`	yes	Revision to compare from.
`to`	`integer`		End of the time range (ISO 8601 date-time with time zone).
`record_id`	`string`	yes	Record id (rec_...)
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_diff",
  "arguments": {
    "record_id": "rec_example",
    "from": 1,
    "to": 2
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_diff",
    "arguments": {
      "record_id": "rec_example",
      "from": 1,
      "to": 2
    }
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/records/rec_example/diff" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

CLI

agentdb cms diff [options] <record> <from> [to]

#`cms_get`

stable added in 1.0.0-rc.6 read-only

One content type's delivery settings and published item count.

MCP tool: cms_get
REST: GET /v1/workspaces/{ws}/cms/types/{object} scope schema:read

Arguments

Argument	Type	Required	Description
`object`	`string`	yes	Object name, e.g. cms_post
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_get",
  "arguments": {
    "object": "cms_post"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_get",
    "arguments": {
      "object": "cms_post"
    }
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/cms/types/cms_post" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

#`cms_list`

stable added in 1.0.0-rc.6 read-only

CMS content types and their delivery settings.

MCP tool: cms_list
REST: GET /v1/workspaces/{ws}/cms/types scope schema:read

Arguments

Argument	Type	Required	Description
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_list",
  "arguments": {}
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_list",
    "arguments": {}
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/cms/types" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

#`cms_preview`

stable added in 1.0.0-rc.6 read-only

What the delivery API returns for a type (or one slug), without a token.

MCP tool: cms_preview
REST: POST /v1/workspaces/{ws}/cms/preview scope records:read

Arguments

Argument	Type	Required	Description
`object`	`string`	yes	Object type name, e.g. contact.
`slug`	`string`		string, 1–500 characters
`locale`	`string`		string, 1–35 characters
`limit`	`integer`		integer, 1–100, default 20
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_preview",
  "arguments": {
    "object": "cms_post",
    "slug": "hello-world"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_preview",
    "arguments": {
      "object": "cms_post",
      "slug": "hello-world"
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/cms/preview" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"object":"cms_post","slug":"hello-world"}'

#`cms_publish`

stable added in 1.0.0-rc.6 changes data

Publish an item that is in review (or re-publish a published one with its latest edits): takes the immutable snapshot the delivery API serves. Edits made while published are not delivered until you publish again. An approval policy may require approvals_submit instead.

MCP tool: cms_publish
REST: POST /v1/workspaces/{ws}/records/{record}/publish scope records:write
CLI: agentdb cms publish

Arguments

Argument	Type	Required	Description
`version`	`integer`		The current version of the item. The call fails with VERSION_CONFLICT if it changed.
`record_id`	`string`	yes	Record id (rec_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_publish",
  "arguments": {
    "record_id": "rec_example",
    "version": 2
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_publish",
    "arguments": {
      "record_id": "rec_example",
      "version": 2
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/records/rec_example/publish" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"version":2}'

CLI

agentdb cms publish [options] <record>

#`cms_restore`

stable added in 1.0.0-rc.6 changes data

Restore the content of an earlier revision as a new version (needs the current version; the status stays).

MCP tool: cms_restore
REST: POST /v1/workspaces/{ws}/records/{record}/restore-revision scope records:write
CLI: agentdb cms restore

Arguments

Argument	Type	Required	Description
`revision`	`integer`	yes	Revision to restore.
`version`	`integer`	yes	The current version of the item. The call fails with VERSION_CONFLICT if it changed.
`record_id`	`string`	yes	Record id (rec_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

version is the record's current version; revision comes from cms_revisions.

MCP

{
  "tool": "cms_restore",
  "arguments": {
    "record_id": "rec_example",
    "revision": 1,
    "version": 3
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_restore",
    "arguments": {
      "record_id": "rec_example",
      "revision": 1,
      "version": 3
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/records/rec_example/restore-revision" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"revision":1,"version":3}'

CLI

agentdb cms restore [options] <record> <revision>

#`cms_revision_get`

stable added in 1.0.0-rc.6 read-only

The full data of one revision.

MCP tool: cms_revision_get
REST: GET /v1/workspaces/{ws}/records/{record}/revisions/{revision} scope records:read

Arguments

Argument	Type	Required	Description
`record_id`	`string`	yes	Record id (rec_...)
`revision`	`integer`	yes	Version number
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_revision_get",
  "arguments": {
    "record_id": "rec_example",
    "revision": 1
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_revision_get",
    "arguments": {
      "record_id": "rec_example",
      "revision": 1
    }
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/records/rec_example/revisions/1" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

#`cms_revisions`

stable added in 1.0.0-rc.6 read-only

Every version of a CMS item (newest first) with status, author and which one is published; pending_changes says whether edits are unpublished.

MCP tool: cms_revisions
REST: GET /v1/workspaces/{ws}/records/{record}/revisions scope records:read
CLI: agentdb cms revisions

Arguments

Argument	Type	Required	Description
`limit`	`integer`		integer, 1–100, default 50
`before`	`integer`		integer, at least 1
`record_id`	`string`	yes	Record id (rec_...)
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_revisions",
  "arguments": {
    "record_id": "rec_example",
    "limit": 10
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_revisions",
    "arguments": {
      "record_id": "rec_example",
      "limit": 10
    }
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/records/rec_example/revisions" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

CLI

agentdb cms revisions [options] <record>

#`cms_schedule_publish`

stable added in 1.0.0-rc.6 changes data

Publish an item at a future time (a one-off scheduler job; owners/admins). The item must then be in a status that may move to published (e.g. in_review).

MCP tool: cms_schedule_publish
REST: POST /v1/workspaces/{ws}/records/{record}/schedule-publish scope records:write

Arguments

Argument	Type	Required	Description
`at`	`string`	yes	When to publish (ISO 8601 date-time).
`record_id`	`string`	yes	Record id (rec_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_schedule_publish",
  "arguments": {
    "record_id": "rec_example",
    "at": "2026-12-01T08:00:00Z"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_schedule_publish",
    "arguments": {
      "record_id": "rec_example",
      "at": "2026-12-01T08:00:00Z"
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/records/rec_example/schedule-publish" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"at":"2026-12-01T08:00:00Z"}'

#`cms_tokens_create`

stable added in 1.0.0-rc.6 changes data

Create a read-only delivery token for websites (optionally limited to types, origins, an expiry). Shown once; stored as SHA-256.

MCP tool: cms_tokens_create
REST: POST /v1/workspaces/{ws}/cms/delivery-tokens scope schema:write

Arguments

Argument	Type	Required	Description
`label`	`string`	yes	A name for this item, shown in lists. (min length 1, max length 100)
`types`	`string[]`		string[], up to 50 items
`expires_in_days`	`integer`		integer, 1–3650
`allowed_origins`	`string[]`		string[], up to 20 items
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_tokens_create",
  "arguments": {
    "label": "Website",
    "types": [
      "cms_post"
    ],
    "expires_in_days": 90
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_tokens_create",
    "arguments": {
      "label": "Website",
      "types": [
        "cms_post"
      ],
      "expires_in_days": 90
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/cms/delivery-tokens" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"label":"Website","types":["cms_post"],"expires_in_days":90}'

#`cms_tokens_list`

stable added in 1.0.0-rc.6 read-only

Delivery tokens (never the secret) with status and last use.

MCP tool: cms_tokens_list
REST: GET /v1/workspaces/{ws}/cms/delivery-tokens scope schema:read

Arguments

Argument	Type	Required	Description
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_tokens_list",
  "arguments": {}
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_tokens_list",
    "arguments": {}
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/cms/delivery-tokens" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

#`cms_tokens_revoke`

stable added in 1.0.0-rc.6 changes data destructive

Revoke a delivery token at once.

MCP tool: cms_tokens_revoke
REST: DELETE /v1/workspaces/{ws}/cms/delivery-tokens/{token} scope schema:write

Arguments

Argument	Type	Required	Description
`token_id`	`string`	yes	Token id (dtk_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_tokens_revoke",
  "arguments": {
    "token_id": "dtk_example"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_tokens_revoke",
    "arguments": {
      "token_id": "dtk_example"
    }
  }
}

REST

curl -s -X DELETE "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/cms/delivery-tokens/dtk_example" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

#`cms_unconfigure`

stable added in 1.0.0-rc.6 changes data destructive

Stop treating an object as a content type: nothing of it is delivered any more. Records and revisions stay.

MCP tool: cms_unconfigure
REST: DELETE /v1/workspaces/{ws}/cms/types/{object} scope schema:write
CLI: agentdb cms unconfigure

Arguments

Argument	Type	Required	Description
`object`	`string`	yes	Object name
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_unconfigure",
  "arguments": {
    "object": "cms_post"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_unconfigure",
    "arguments": {
      "object": "cms_post"
    }
  }
}

REST

curl -s -X DELETE "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/cms/types/cms_post" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

CLI

agentdb cms unconfigure [options] <object>

#`cms_unpublish`

stable added in 1.0.0-rc.6 changes data

Take an item offline by moving it to another status (default archived); the snapshot is removed at once.

MCP tool: cms_unpublish
REST: POST /v1/workspaces/{ws}/records/{record}/unpublish scope records:write
CLI: agentdb cms unpublish

Arguments

Argument	Type	Required	Description
`version`	`integer`		The current version of the item. The call fails with VERSION_CONFLICT if it changed.
`status`	`string`		string, 1–64 characters, default "archived"
`record_id`	`string`	yes	Record id (rec_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "cms_unpublish",
  "arguments": {
    "record_id": "rec_example"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "cms_unpublish",
    "arguments": {
      "record_id": "rec_example"
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/records/rec_example/unpublish" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

CLI

agentdb cms unpublish [options] <record>

#`content_dispatch`

experimental added in 1.0.0-rc.6 changes data

Hand a content post to the operator's outbound publisher. Off by default (FEATURE_DISABLED): AgentDB never posts to social networks itself. Experimental: may change before 2.0.

Experimental: may change before 2.0. Outbound content adapters are off by default and none is approved yet.

MCP tool: content_dispatch
REST: POST /v1/workspaces/{ws}/records/{record}/dispatch scope records:write
CLI: agentdb content dispatch

Arguments

Argument	Type	Required	Description
`channel_field`	`string`		string, up to 64 characters, default "channel"
`record_id`	`string`	yes	Record id (rec_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "content_dispatch",
  "arguments": {
    "record_id": "rec_example"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "content_dispatch",
    "arguments": {
      "record_id": "rec_example"
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/records/rec_example/dispatch" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

CLI

agentdb content dispatch [options] <record>

#`delivery.asset`

stable

An asset of a published item (re-checked on every download)

REST: GET /v1/delivery-assets/{ws}/{file} no authentication

Parameter	In	Type	Required	Description
`ws`	path	`string`	yes	string
`file`	path	`string`	yes	string

Example

REST

curl -s "https://app.agentdb.link/v1/delivery-assets/$AGENTDB_WORKSPACE/<file>"

#`delivery.get`

stable

One published item by slug (?locale=)

REST: GET /v1/delivery/{ws}/{type}/{slug} no authentication

Parameter	In	Type	Required	Description
`ws`	path	`string`	yes	string
`type`	path	`string`	yes	string
`slug`	path	`string`	yes	string

Example

REST

curl -s "https://app.agentdb.link/v1/delivery/$AGENTDB_WORKSPACE/<type>/<slug>"

#`delivery.list`

stable

Published items of a CMS content type (delivery token or public type; ETag, CORS)

REST: GET /v1/delivery/{ws}/{type} no authentication

Parameter	In	Type	Required	Description
`ws`	path	`string`	yes	string
`type`	path	`string`	yes	string

Example

REST

curl -s "https://app.agentdb.link/v1/delivery/$AGENTDB_WORKSPACE/<type>"

#`forms.public.get`

stable

A public form's inputs and a single-use ticket

REST: GET /v1/forms/{ws}/{token} no authentication

Parameter	In	Type	Required	Description
`ws`	path	`string`	yes	string
`token`	path	`string`	yes	string

Example

REST

curl -s "https://app.agentdb.link/v1/forms/$AGENTDB_WORKSPACE/<token>"

#`forms.public.submit`

stable

Submit a public form (application/json; ticket, honeypot, rate limits)

REST: POST /v1/forms/{ws}/{token} no authentication

Parameter	In	Type	Required	Description
`ws`	path	`string`	yes	string
`token`	path	`string`	yes	string

Example

REST

curl -s -X POST "https://app.agentdb.link/v1/forms/$AGENTDB_WORKSPACE/<token>"

#`forms_create`

stable added in 1.0.0-rc.6 changes data

Create a public form that creates records of one object: inputs mapped to fields (validated by the field types), fixed values, honeypot, minimum fill time, optional proof of work, size and rate limits, allowed origins, spam quarantine, inbox notifications. Returns the form token once (the public URL is /v1/forms/<workspace>/<token>). Install {template: "forms"} for a ready inquiry object.

MCP tool: forms_create
REST: POST /v1/workspaces/{ws}/forms scope schema:write
CLI: agentdb forms create

Arguments

Argument	Type	Required	Description
`name`	`string`	yes	Form name: lowercase letters, digits and _.
`object`	`string`	yes	Object type the form creates records in.
`status`	`"active" \| "closed"`		string, one of: active, closed, default "active"
`title`	`string`	yes	Title shown to people. (min length 1, max length 200)
`description`	`string`		string, up to 2000 characters
`fields`	`object[]`	yes	The form's fields, in order. (max 50 items)
`files`	`object[]`		object[], up to 5 items, default []
`fixed_values`	`object`		object, default {}
`honeypot`	`string`		string, default "website"
`min_fill_seconds`	`integer`		integer, 0–3600, default 3
`challenge`	`"none" \| "proof_of_work"`		string, one of: none, proof_of_work, default "none"
`pow_difficulty`	`integer`		integer, 8–24, default 16
`max_bytes`	`integer`		integer, 512–65536, default 16384
`allowed_origins`	`string[] \| null`		string[] \| null, default null
`rate_limits`	`object`		object, default {}
`spam`	`object`		object, default {}
`max_quarantined`	`integer`		integer, 1–10000, default 500
`notify`	`string[]`		string[], up to 10 items, default []
`auto_reply`	`object`		object
`success_message`	`string`		string, up to 500 characters, default "Thank you. We received your message."
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "forms_create",
  "arguments": {
    "name": "contact_us",
    "object": "lead",
    "title": "Contact us",
    "fields": [
      {
        "name": "email",
        "field": "email",
        "label": "Email",
        "required": true
      },
      {
        "name": "message",
        "field": "message",
        "label": "Message",
        "max_length": 2000
      }
    ]
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "forms_create",
    "arguments": {
      "name": "contact_us",
      "object": "lead",
      "title": "Contact us",
      "fields": [
        {
          "name": "email",
          "field": "email",
          "label": "Email",
          "required": true
        },
        {
          "name": "message",
          "field": "message",
          "label": "Message",
          "max_length": 2000
        }
      ]
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/forms" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"contact_us","object":"lead","title":"Contact us","fields":[{"name":"email","field":"email","label":"Email","required":true},{"name":"message","field":"message","label":"Message","max_length":2000}]}'

CLI

agentdb forms create [options]

#`forms_delete`

stable added in 1.0.0-rc.6 changes data destructive

Delete a form and its submission log; records it created stay.

MCP tool: forms_delete
REST: DELETE /v1/workspaces/{ws}/forms/{form} scope schema:write
CLI: agentdb forms delete

Arguments

Argument	Type	Required	Description
`form`	`string`	yes	Form id (frm_...) or name
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "forms_delete",
  "arguments": {
    "form": "contact_us"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "forms_delete",
    "arguments": {
      "form": "contact_us"
    }
  }
}

REST

curl -s -X DELETE "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/forms/contact_us" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

CLI

agentdb forms delete [options] <form>

#`forms_get`

stable added in 1.0.0-rc.6 read-only

One form and its versions.

MCP tool: forms_get
REST: GET /v1/workspaces/{ws}/forms/{form} scope schema:read
CLI: agentdb forms get

Arguments

Argument	Type	Required	Description
`form`	`string`	yes	Form id (frm_...) or name
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "forms_get",
  "arguments": {
    "form": "contact_us"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "forms_get",
    "arguments": {
      "form": "contact_us"
    }
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/forms/contact_us" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

CLI

agentdb forms get [options] <form>

#`forms_list`

stable added in 1.0.0-rc.6 read-only

Forms with their definitions and submission counts (never the token).

MCP tool: forms_list
REST: GET /v1/workspaces/{ws}/forms scope schema:read
CLI: agentdb forms list

Arguments

Argument	Type	Required	Description
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "forms_list",
  "arguments": {}
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "forms_list",
    "arguments": {}
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/forms" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

CLI

agentdb forms list [options]

#`forms_review`

stable added in 1.0.0-rc.6 changes data

Release a quarantined submission (creates its record) or discard it (erases its data).

MCP tool: forms_review
REST: POST /v1/workspaces/{ws}/form-submissions/{submission}/review scope records:write

Arguments

Argument	Type	Required	Description
`decision`	`"release" \| "discard"`	yes	release keeps the submission; discard removes it.
`comment`	`string`		string, up to 2000 characters
`submission_id`	`string`	yes	Submission id (fsb_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

submission_id comes from forms_submissions.

MCP

{
  "tool": "forms_review",
  "arguments": {
    "submission_id": "fsb_example",
    "decision": "release",
    "comment": "Not spam."
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "forms_review",
    "arguments": {
      "submission_id": "fsb_example",
      "decision": "release",
      "comment": "Not spam."
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/form-submissions/fsb_example/review" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"decision":"release","comment":"Not spam."}'

#`forms_rotate_token`

stable added in 1.0.0-rc.6 changes data

Give a form a new public token; the old link stops working at once.

MCP tool: forms_rotate_token
REST: POST /v1/workspaces/{ws}/forms/{form}/rotate-token scope schema:write
CLI: agentdb forms rotate-token

Arguments

Argument	Type	Required	Description
`form`	`string`	yes	Form id (frm_...) or name
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "forms_rotate_token",
  "arguments": {
    "form": "contact_us"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "forms_rotate_token",
    "arguments": {
      "form": "contact_us"
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/forms/contact_us/rotate-token" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

CLI

agentdb forms rotate-token [options] <form>

#`forms_submissions`

stable added in 1.0.0-rc.6 read-only

Submission log (newest first): accepted (with record_id), quarantined (with the untrusted data to review), released, discarded.

MCP tool: forms_submissions
REST: GET /v1/workspaces/{ws}/form-submissions scope records:read
CLI: agentdb forms submissions

Arguments

Argument	Type	Description
`form`	`string`	string, up to 100 characters
`status`	`"accepted" \| "quarantined" \| "released" \| "discarded"`	string, one of: accepted, quarantined, released, discarded
`limit`	`integer`	integer, 1–200, default 50
`after`	`string`	string, up to 64 characters
`workspace`	`string`	Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "forms_submissions",
  "arguments": {
    "form": "contact_us",
    "status": "quarantined",
    "limit": 20
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "forms_submissions",
    "arguments": {
      "form": "contact_us",
      "status": "quarantined",
      "limit": 20
    }
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/form-submissions" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

CLI

agentdb forms submissions [options]

#`forms_update`

stable added in 1.0.0-rc.6 changes data

Change parts of a form's definition or close it (status: closed). Needs the current version; each change is a new version.

MCP tool: forms_update
REST: PATCH /v1/workspaces/{ws}/forms/{form} scope schema:write
CLI: agentdb forms update

Arguments

Argument	Type	Required	Description
`version`	`integer`	yes	The current version of the item. The call fails with VERSION_CONFLICT if it changed.
`status`	`"active" \| "closed"`		string, one of: active, closed
`form`	`string`	yes	Form id (frm_...) or name
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "forms_update",
  "arguments": {
    "form": "contact_us",
    "version": 1,
    "status": "closed"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "forms_update",
    "arguments": {
      "form": "contact_us",
      "version": 1,
      "status": "closed"
    }
  }
}

REST

curl -s -X PATCH "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/forms/contact_us" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"version":1,"status":"closed"}'

CLI

agentdb forms update [options] <form>

Publishing

#cms_configure

Arguments

Example

#cms_diff

Arguments

Example

#cms_get

Arguments

Example

#cms_list

Arguments

Example

#cms_preview

Arguments

Example

#cms_publish

Arguments

Example

#cms_restore

Arguments

Example

#cms_revision_get

Arguments

Example

#cms_revisions

Arguments

Example

#cms_schedule_publish

Arguments

Example

#cms_tokens_create

Arguments

Example

#cms_tokens_list

Arguments

Example

#cms_tokens_revoke

Arguments

Example

#cms_unconfigure

Arguments

Example

#cms_unpublish

Arguments

Example

#content_dispatch

Arguments

Example

#delivery.asset

Example

#delivery.get

Example

#delivery.list

Example

#forms.public.get

Example

#forms.public.submit

Example

#forms_create

Arguments

Example

#forms_delete

Arguments

Example

#forms_get

Arguments

Example

#forms_list

Arguments

Example

#forms_review

Arguments

Example

#forms_rotate_token

Arguments

Example

#forms_submissions

Arguments

Example

#`cms_configure`

#`cms_diff`

#`cms_get`

#`cms_list`

#`cms_preview`

#`cms_publish`

#`cms_restore`

#`cms_revision_get`

#`cms_revisions`

#`cms_schedule_publish`

#`cms_tokens_create`

#`cms_tokens_list`

#`cms_tokens_revoke`

#`cms_unconfigure`

#`cms_unpublish`

#`content_dispatch`

#`delivery.asset`

#`delivery.get`

#`delivery.list`

#`forms.public.get`

#`forms.public.submit`

#`forms_create`

#`forms_delete`

#`forms_get`

#`forms_list`

#`forms_review`

#`forms_rotate_token`

#`forms_submissions`

#`forms_update`