digitalpublic-com Process Designer API
The Process Designer API from digitalpublic-com — 1 operation(s) for process designer.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/digitalpublic-com:digitalpublic-com-process-designer-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: DigitalPublic Agent Process Designer API
version: 2026-09-10-trial-active-projects-v1
description: API for external AI agents to interact with DigitalPublic projects. Provides discovery, project context, Google Ads, Meta Ads, LinkedIn organic and LinkedIn Ads, Merchant Center, SEO, AEO, Search Console, WordPress, Analytics, Tag Manager, Business Profile, mailings, CRM, comments, reports, and scheduling.
contact:
email: soporte@digitalpublic.com
servers:
- url: https://platform.digitalpublic.com
description: Production
security:
- bearerAuth: []
tags:
- name: Process Designer
paths:
/api/agent/process-designer:
post:
summary: Declarative process designer
description: Design, validate, publish and instantiate project-scoped graph workflows. Mutating tools require both write and process:manage. Definitions cannot contain executable code, arbitrary HTTP calls, SQL, unregistered tools or unregistered verifiers.
tags:
- Process Designer
requestBody:
content:
application/json:
schema:
type: object
required:
- tool
properties:
tool:
type: string
params:
type: object
additionalProperties: true
responses:
'200':
description: Designer operation succeeded.
'403':
description: write and process:manage are required for mutations.
'409':
description: Stale migration preview, active execution or immutable version conflict.
x-tools:
- name: list_process_capabilities
description: List process-eligible tools, node types, structured human checkpoints, supervised-browser evidence, conditions, verifiers and declarative contract rules. Includes wordpress_editorial_publication, wordpress_page_remediation and social_article_distribution with mandatory approval, idempotent resume, public verification and SCHEDULE_NEXT gating.
params: {}
x-mcp:
channel: process_designer
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: list_workflow_templates
description: List global, group and project templates visible from the selected project.
params: {}
x-mcp:
channel: process_designer
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: get_workflow_template
description: Read a visible template, ownership, origin and version history.
params:
templateId:
type: string
required: true
x-mcp:
channel: process_designer
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: get_workflow_version
description: Read one immutable workflow version with definition, configSchema, validation and hash.
params:
versionId:
type: string
required: true
x-mcp:
channel: process_designer
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: get_project_process
description: Read a project process, pinned version, graph runs, node attempts and evidence.
params:
taskId:
type: string
required: true
x-mcp:
channel: process_designer
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: validate_workflow_definition
description: Validate graph topology, schemas, registered capabilities, safe conditions and completion gates without saving it.
params:
definition:
type: object
required: true
configSchema:
type: object
required: true
x-mcp:
channel: process_designer
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: preview_task_process_migration
description: Create a short-lived migration preview with exact tasks, process definitions, schedules, warnings, previewId and snapshotHash. It never starts a process.
params:
taskIds:
type: array
required: true
processes:
type: array
required: true
x-mcp:
channel: process_designer
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: preview_process_run_recovery
description: Dry-run recovery of a waiting, blocked or failed run onto a compatible published version. A failed data verifier may reopen its immediate read-only source on the unchanged graph when no downstream work succeeded. Returns preserved and invalidated evidence without sending email or applying external mutations.
params:
processRunId:
type: string
required: true
targetWorkflowVersionId:
type: string
required: true
targetNodeKey:
type: string
required: true
reason:
type: string
required: true
x-mcp:
channel: process_designer
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: preview_process_run_correction
description: Preview correction of period, version and configuration in the same stopped run using its frozen date anchor. Classifies incompatible evidence, preserves trigger and history, and never advances work.
params:
processRunId:
type: string
required: true
targetWorkflowVersionId:
type: string
required: true
processConfig:
type: object
required: true
reportPeriod:
type: string
required: true
reason:
type: string
required: true
x-mcp:
channel: process_designer
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: get_process_migration
description: Read a migration preview or its applied result.
params:
previewId:
type: string
required: true
x-mcp:
channel: process_designer
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: create_project_workflow_draft
description: Create an isolated PROJECT workflow draft, optionally derived from a visible template. An optional idempotencyKey makes retries safe. Requires write + process:manage.
params:
name:
type: string
required: true
description:
type: string
optional: true
originTemplateId:
type: string
optional: true
definition:
type: object
required: true
configSchema:
type: object
required: true
idempotencyKey:
type: string
optional: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: save_project_workflow_draft
description: Save changes as a new immutable version. Optional idempotencyKey and expectedLatestVersion guard retries and concurrent edits. Requires write + process:manage.
params:
templateId:
type: string
required: true
definition:
type: object
required: true
configSchema:
type: object
required: true
idempotencyKey:
type: string
optional: true
expectedLatestVersion:
type: number
optional: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: publish_project_workflow_version
description: Validate and publish a project version for use only in its project. Optional expectedLatestVersion guards concurrent edits. Requires write + process:manage.
params:
templateId:
type: string
required: true
versionId:
type: string
required: true
expectedLatestVersion:
type: number
optional: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: create_project_process
description: Instantiate a published visible workflow with schema-validated client configuration. Does not start a run. Requires write + process:manage.
params:
process:
type: object
required: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: update_project_process_config
description: Update configuration and optionally its published workflow version when no run is active. Preserves task, history and schedule. Version changes require expectedWorkflowVersionId. Requires write + process:manage.
params:
taskId:
type: string
required: true
processConfig:
type: object
required: true
workflowVersionId:
type: string
optional: true
expectedWorkflowVersionId:
type: string
optional: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: pause_project_process
description: Pause future scheduling for a process with no active run. Requires write + process:manage.
params:
taskId:
type: string
required: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: resume_project_process
description: Resume a paused project process without starting it. Requires write + process:manage.
params:
taskId:
type: string
required: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: reschedule_project_process
description: Replace the next trigger with an audited future schedule when no run is active, while preserving prior runs and their frozen periods. Requires write + process:manage.
params:
taskId:
type: string
required: true
nextRunAt:
type: string
required: true
reason:
type: string
required: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: cancel_process_run
description: Cancel a non-terminal run only before tools, artifacts or an active node can produce external effects. Preserves run history and records the reason. Requires write + process:manage.
params:
processRunId:
type: string
required: true
reason:
type: string
required: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: preview_administrative_process_closure
description: Previsualiza el cierre administrativo de un ciclo BLOCKED o WAITING_HUMAN exacto. Conserva resultado de negocio, evidencia y programación. Bloquea reservas y envíos en curso. Requiere write y process:manage.
params:
processRunId:
type: string
required: true
reason:
type: string
required: true
x-mcp:
channel: process_designer
effect: read
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: apply_administrative_process_closure
description: Cierra administrativamente el ciclo exacto de una previsualización vigente con autorización explícita. Preserva entregas enviadas, publicaciones, CRM, confirmaciones y verificaciones. Invalida pasos y autorizaciones futuros. Conserva programación, tareas pausadas y procesos sustitutos. Idempotencia por ciclo y control de concurrencia.
params:
processRunId:
type: string
required: true
previewId:
type: string
required: true
snapshotHash:
type: string
required: true
reason:
type: string
required: true
humanAuthorizationReference:
type: string
required: true
idempotencyKey:
type: string
required: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: human
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: close_process_run
description: 'Governedly close a BLOCKED or FAILED run, or close a WAITING_AGENT or WAITING_HUMAN run with verified completion or REQUIREMENT_WITHDRAWN, after an authorized human confirms its final outcome. FAILED runs whose process contract has a required communication delivery need project-scoped evidence: a confirmed SENT email with sentAt and messageId, or an authorized report with sentAt. A process contract with no required communication deliveries can close without email or report evidence. Completion while waiting, or delivery before failure, requires both emailId and reportId, sent during this run, with the frozen period, required audience/purpose, matching route/version, linked report and exact authorized email snapshot. Preserves resources, failure history and evidence, skips every remaining action, invalidates unsent delivery authorizations and releases the task without sending. Recurring processes atomically advance from the closed occurrence according to their frequency; custom schedules can then use reschedule_project_process. Requires write + process:manage.'
params:
processRunId:
type: string
required: true
reason:
type: string
required: true
humanAuthorizationReference:
type: string
required: true
description: Auditable reference to the human decision authorizing closure.
finalOutcome:
type: string
required: true
enum:
- DELIVERABLES_COMPLETED
- REQUIREMENT_WITHDRAWN
evidence:
type: object
optional: true
description: Required for waiting completion and FAILED runs with required communication delivery. Completion before failure or while waiting requires emailId and reportId with strict contract correlation.
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: human
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: start_process_period
description: Start the next scheduled occurrence early after an explicit human decision. reportPeriod and scheduledFor must match that occurrence. Uses its canonical recurring trigger key so the later scheduled trigger cannot duplicate the run. Preserves the task schedule and rejects an open previous run. Requires write + process:manage.
params:
taskId:
type: string
required: true
reportPeriod:
type: string
required: true
description: Explicit YYYY-MM report period matching the next occurrence.
scheduledFor:
type: string
required: true
description: Exact ISO8601 nextRunAt returned by get_project_process.
humanAuthorizationReference:
type: string
required: true
idempotencyKey:
type: string
required: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: human
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: apply_task_process_migration
description: Atomically apply an unchanged preview, preserve history, pause replaced tasks and create processes without starting runs. Requires previewId, snapshotHash, idempotencyKey, reason and write + process:manage.
params:
previewId:
type: string
required: true
snapshotHash:
type: string
required: true
idempotencyKey:
type: string
required: true
reason:
type: string
required: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: apply_process_run_recovery
description: Create an audited recovery run for the same frozen period, pin the task to the target version and invalidate downstream artifacts without duplicating sent email. Requires write + process:manage.
params:
previewId:
type: string
required: true
snapshotHash:
type: string
required: true
idempotencyKey:
type: string
required: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: apply_process_run_correction
description: Apply a fenced unchanged preview to the same run and trigger. Preserve historical attempts and evidence, replace readiness with a new unclaimed attempt, audit before/after, and never advance work or send email. Requires write + process:manage.
params:
previewId:
type: string
required: true
snapshotHash:
type: string
required: true
idempotencyKey:
type: string
required: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: none
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: request_workflow_promotion
description: Request human-reviewed promotion of a clean project variant to GROUP or GLOBAL. Client identifiers are rejected before submission. Requires write + process:manage.
params:
templateId:
type: string
required: true
targetScope:
type: string
required: true
enum:
- GROUP
- GLOBAL
targetGroupId:
type: string
optional: true
reason:
type: string
required: true
x-mcp:
channel: process_designer
effect: write
requiredScope: write
approval: human
requestShape: tool_params
additionalScopes:
- process:manage
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
operationId: postApiAgentProcessDesigner
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Project API key starting with dpk_ or global agent token starting with dpa_. dpa_ requests must include projectId or X-DigitalPublic-Project-Id for project-scoped endpoints.
x-commercial-channels:
- key: google_ads
label:
es: Google Ads
en: Google Ads
commercialModule: google_ads
services:
- googleAds
mcpChannels:
- google_ads
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases:
- google-ads
- key: wordpress
label:
es: WordPress
en: WordPress
commercialModule: seo_aeo
services:
- wordpressSeo
mcpChannels:
- wordpress
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases:
- wordpress-seo
- key: crm
label:
es: CRM
en: CRM
commercialModule: crm
services:
- crm
mcpChannels:
- crm
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases: []
- key: websites
label:
es: Sitios web
en: Websites
commercialModule: content_web
services:
- landingPages
mcpChannels:
- landing_pages
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases:
- landing-pages
- landing_pages
- sites-web
- sites_web
- key: social
label:
es: Redes sociales
en: Social media
commercialModule: social
services:
- socialOrganic
- socialX
- socialLinkedIn
mcpChannels:
- social
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases: []
- key: blog
label:
es: Blog
en: Blog
commercialModule: content_web
services:
- blog
mcpChannels:
- blog
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases: []
- key: meta_ads
label:
es: Meta Ads
en: Meta Ads
commercialModule: meta_ads
services:
- metaAds
mcpChannels:
- meta_ads
public: true
availability: limited
access: read_write
requiresConnection: true
acceptedAliases:
- meta-ads
- meta
- key: linkedin_ads
label:
es: LinkedIn Ads
en: LinkedIn Ads
commercialModule: linkedin_ads
services:
- linkedinAds
mcpChannels:
- linkedin_ads
public: true
availability: limited
access: read_write
requiresConnection: true
acceptedAliases:
- linkedin-ads
- linkedin
- key: seo
label:
es: SEO y AEO
en: SEO and AEO
commercialModule: seo_aeo
services:
- seo
- aeo
mcpChannels:
- seo_tools
- aeo
public: true
availability: limited
access: read_write
requiresConnection: false
acceptedAliases: []
- key: analytics
label:
es: Analítica
en: Analytics
commercialModule: analytics
services:
- analytics
mcpChannels:
- analytics
public: true
availability: limited
access: read
requiresConnection: true
acceptedAliases: []
- key: search_console
label:
es: Search Console
en: Search Console
commercialModule: search_console
services:
- searchConsole
mcpChannels:
- search_console
public: true
availability: limited
access: read_write
requiresConnection: true
acceptedAliases:
- search-console
- key: email
label:
es: Email y newsletters
en: Email and newsletters
commercialModule: email_marketing
services:
- mailings
mcpChannels:
- mailings
public: true
availability: limited
access: read_write
requiresConnection: true
acceptedAliases:
- brevo