digitalpublic-com Scheduling API
The Scheduling API from digitalpublic-com — 1 operation(s) for scheduling.
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-scheduling-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 Scheduling 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: Scheduling
paths:
/api/agent/schedule:
post:
summary: External and embedded agent task scheduling
description: List and manage project tasks/subtasks. EXTERNAL tasks are executed by the connected agent runtime. EMBEDDED task drafts may be proposed through this API, but require human activation before DigitalPublic's internal scheduler can run them. complete_execution rejects ambiguous completions from external agents.
tags:
- Scheduling
requestBody:
content:
application/json:
schema:
type: object
required:
- tool
properties:
tool:
type: string
enum:
- list_tasks
- list_due_tasks
- get_task
- get_task_by_url
- list_embedded_runs
- create_task
- create_embedded_task_draft
- update_task
- delete_task
- postpone_task
- start_execution
- append_task_message
- append_execution_message
- update_task_message
- delete_task_message
- complete_execution
params:
type: object
additionalProperties: true
responses:
'200':
description: Success
x-tools:
- name: list_tasks
description: List project tasks and subtasks.
params: {}
x-mcp:
channel: schedule
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: list_due_tasks
description: List active tasks that are due or require a new execution date. Every handled task must finish with complete_execution or postpone_task.
params: {}
x-mcp:
channel: schedule
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: get_task
description: Get task detail with recent executions, task messages, and the canonical taskUrl.
params:
taskId:
type: string
required: true
x-mcp:
channel: schedule
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: get_task_by_url
description: Resolve a copied DigitalPublic task URL and return the task detail with messages, instructions, executions, and canonical taskUrl. Use this when the user says only 'Ejecuta esta tarea' and provides the URL.
params:
taskUrl:
type: string
required: true
x-mcp:
channel: schedule
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: list_embedded_runs
description: List recent executions performed by DigitalPublic's embedded agent runtime for this project.
params:
status:
type: string
optional: true
enum:
- QUEUED
- RUNNING
- WAITING_APPROVAL
- WAITING_PROVIDER
- BLOCKED_QUOTA
- SUCCEEDED
- FAILED
- CANCELLED
limit:
type: number
optional: true
x-mcp:
channel: schedule
effect: read
requiredScope: read
approval: none
requestShape: tool_params
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: create_task
description: Create a task for the external agent runtime. Requires write scope.
params:
title:
type: string
required: true
description:
type: string
optional: true
instructions:
type: string
optional: true
parentId:
type: string
optional: true
verificationMode:
type: string
optional: true
enum:
- LEGACY
- CONTRACT
default: LEGACY
description: LEGACY is a fully supported prompt-driven simple task. CONTRACT adds typed-evidence verification.
status:
type: string
optional: true
enum:
- active
- paused
- completed
frequency:
type: string
optional: true
enum:
- manual
- daily
- weekly
- every_two_weeks
- monthly
- every_two_months
- quarterly
- semiannual
- annual
- custom
nextRunAt:
type: string
optional: true
description: Authoritative ISO8601 execution date.
reason:
type: string
optional: true
description: Reason recorded in the scheduling audit.
sortOrder:
type: number
optional: true
serviceArea:
type: string
optional: true
clientVisible:
type: boolean
optional: true
default: false
clientTitle:
type: string
optional: true
clientSummary:
type: string
optional: true
x-mcp:
channel: schedule
effect: write
requiredScope: write
approval: none
requestShape: tool_params
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: create_embedded_task_draft
description: Propose a scheduled task for DigitalPublic's embedded agent. It is always paused and in DRAFT state until a human activates it. Requires write scope.
params:
title:
type: string
required: true
description:
type: string
optional: true
instructions:
type: string
required: true
frequency:
type: string
optional: true
enum:
- manual
- daily
- weekly
- every_two_weeks
- monthly
- every_two_months
- quarterly
- semiannual
- annual
- custom
nextRunAt:
type: string
optional: true
description: Proposed first execution date. A human may change it while activating the draft.
timezone:
type: string
optional: true
description: IANA timezone.
scheduleRule:
type: object
optional: true
serviceArea:
type: string
optional: true
aiProfile:
type: string
optional: true
enum:
- ECONOMY
- STANDARD
- DEEP
description: Model and cost profile. Defaults to STANDARD.
reason:
type: string
optional: true
x-mcp:
channel: schedule
effect: write
requiredScope: write
approval: human
requestShape: tool_params
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: update_task
description: Update project task scheduling, content, status, order, or parentId to move it in the task tree. Requires write scope.
params:
taskId:
type: string
required: true
parentId:
type: string
optional: true
description: New parent task id. Send null or empty string to move the task to the root.
title:
type: string
optional: true
description:
type: string
optional: true
instructions:
type: string
optional: true
status:
type: string
optional: true
enum:
- active
- paused
- completed
frequency:
type: string
optional: true
enum:
- manual
- daily
- weekly
- every_two_weeks
- monthly
- every_two_months
- quarterly
- semiannual
- annual
- custom
nextRunAt:
type: string
optional: true
description: Authoritative ISO8601 date selected by the agent or human.
reason:
type: string
optional: true
description: Reason recorded with the previous and new schedule state.
sortOrder:
type: number
optional: true
serviceArea:
type: string
optional: true
clientVisible:
type: boolean
optional: true
clientTitle:
type: string
optional: true
clientSummary:
type: string
optional: true
x-mcp:
channel: schedule
effect: write
requiredScope: write
approval: none
requestShape: tool_params
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: delete_task
description: Delete a project task and its subtasks/executions. Requires write scope.
params:
taskId:
type: string
required: true
x-mcp:
channel: schedule
effect: write
requiredScope: write
approval: none
requestShape: tool_params
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: postpone_task
description: Postpone a task that cannot be completed yet. Records a deferred execution with reason, message, future date and optional diagnostic evidence, and updates nextRunAt without changing frequency. Requires write scope.
params:
taskId:
type: string
required: true
nextRunAt:
type: string
required: true
description: Future ISO8601 date for the next check.
reason:
type: string
required: true
evidence:
type: object
optional: true
description: Diagnostic evidence for the postponement; preserves deferred status.
x-mcp:
channel: schedule
effect: write
requiredScope: write
approval: none
requestShape: tool_params
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: start_execution
description: Start a task execution. Requires write scope.
params:
taskId:
type: string
required: true
scheduledFor:
type: string
optional: true
clientVisible:
type: boolean
optional: true
clientSummary:
type: string
optional: true
evidence:
type: object
optional: true
x-mcp:
channel: schedule
effect: write
requiredScope: write
approval: none
requestShape: tool_params
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: append_task_message
description: Append a human-readable agent message to a task. Put the result and next human action in content; put identifiers, metrics, diagnostics and sanitized evidence in technicalDetails. Both support Markdown/GFM. Link DigitalPublic resources with typed resourceReferences, never hand-built internal URLs. Messages default to internal; set visibility=client only for approved partner-portal content. Requires write scope.
params:
taskId:
type: string
required: true
content:
type: string
required: true
description: Human-readable Markdown/GFM summary, maximum 1,000 characters.
technicalDetails:
type: string
optional: true
description: Optional technical Markdown/GFM detail, maximum 15,000 characters.
resourceReferences:
type: array
optional: true
description: 'Typed DigitalPublic resources: [{resourceType,resourceId}]. IDs are validated in the authenticated project.'
messageKind:
type: string
optional: true
enum:
- client
- blobic
- note
visibility:
type: string
optional: true
enum:
- internal
- client
default: internal
x-mcp:
channel: schedule
effect: write
requiredScope: write
approval: none
requestShape: tool_params
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: append_execution_message
description: Append a human-readable agent message to an execution. Put the result and next human action in content; use technicalDetails for technical evidence and resourceReferences for verified internal resources. Messages default to internal. Requires write scope.
params:
executionId:
type: string
required: true
content:
type: string
required: true
description: Human-readable Markdown/GFM summary, maximum 1,000 characters.
technicalDetails:
type: string
optional: true
description: Optional technical Markdown/GFM detail, maximum 15,000 characters.
resourceReferences:
type: array
optional: true
description: 'Typed DigitalPublic resources: [{resourceType,resourceId}].'
messageKind:
type: string
optional: true
enum:
- client
- blobic
- note
visibility:
type: string
optional: true
enum:
- internal
- client
default: internal
x-mcp:
channel: schedule
effect: write
requiredScope: write
approval: none
requestShape: tool_params
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: update_task_message
description: Update a task or execution message. Human-readable summary, technical details and typed resource references are independently editable. Requires write scope. Author fields are immutable.
params:
messageId:
type: string
required: true
content:
type: string
optional: true
description: Human-readable Markdown/GFM summary, maximum 1,000 characters.
technicalDetails:
type: string
optional: true
description: Optional technical Markdown/GFM detail, maximum 15,000 characters.
resourceReferences:
type: array
optional: true
description: 'Typed DigitalPublic resources: [{resourceType,resourceId}].'
messageKind:
type: string
optional: true
enum:
- client
- blobic
- note
visibility:
type: string
optional: true
enum:
- internal
- client
x-mcp:
channel: schedule
effect: write
requiredScope: write
approval: none
requestShape: tool_params
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: delete_task_message
description: Delete a task or execution message. Requires write scope.
params:
messageId:
type: string
required: true
x-mcp:
channel: schedule
effect: write
requiredScope: write
approval: none
requestShape: tool_params
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: complete_execution
description: Finish a simple-task execution. operationalOutcome is authoritative and DigitalPublic derives technical status. Legacy status=skipped without an outcome means NO_ACTION_REQUIRED, not BLOCKED. A next-run decision is mandatory (NEXT_RUN_DECISION_REQUIRED). Contract tasks require verified typed evidence. Delivering drafts requires evidence.reviewContentIds with persisted contents from this execution and project. A task note is only history. Use submit_review_draft when the publishing destination is missing; preserve BLOCKED if storage fails.
params:
executionId:
type: string
required: true
status:
type: string
optional: true
enum:
- completed
- failed
- skipped
description: Legacy compatibility field. Prefer operationalOutcome.
operationalOutcome:
type: string
optional: true
enum:
- ACTION_COMPLETED
- NO_ACTION_REQUIRED
- BLOCKED
- FAILED
description: Authoritative result. Required for contract tasks.
summary:
type: string
optional: true
description: Human-readable Markdown/GFM summary, maximum 1,000 characters.
technicalDetails:
type: string
optional: true
description: Optional technical Markdown/GFM detail kept separate from the human summary.
resourceReferences:
type: array
optional: true
description: Additional typed DigitalPublic resources. REPORT, EMAIL and PLATFORM_OPERATION evidence is linked automatically.
errorMessage:
type: string
optional: true
clientVisible:
type: boolean
optional: true
clientSummary:
type: string
optional: true
evidence:
type: object
optional: true
nextRunAt:
type: string
optional: true
description: Future ISO8601 date selected by the agent. Mutually exclusive with nextRunDecision.
nextRunDecision:
type: string
optional: true
enum:
- use_frequency
- close
description: Required when nextRunAt is omitted. use_frequency explicitly applies a predefined cadence; close archives the task.
nextRunReason:
type: string
optional: true
description: Required when nextRunDecision='close' to record why no future execution is needed.
x-mcp:
channel: schedule
effect: write
requiredScope: write
approval: none
requestShape: tool_params
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
operationId: postApiAgentSchedule
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