---
title: "Confirm a deferred schedule as the account owner"
method: POST
path: "/v1/agents/{agentID}/schedules/{scheduleID}/confirm"
---

# Confirm a deferred schedule as the account owner

`POST /v1/agents/{agentID}/schedules/{scheduleID}/confirm`

## Request

- Base URL: `https://api.plori.ai`
- URL: `https://api.plori.ai/v1/agents/{agentID}/schedules/{scheduleID}/confirm`
- Auth: HTTP bearer

Requires the owner's own plori_sk_ API key or OAuth access token outside MCP. Takes no body. Changes awaiting_confirmation to pending and records confirmed_at only while fire_at is in the future. An already confirmed row returns 200 unchanged. MCP requests receive 403 with the confirmation link in the error text.

## Path parameters

- `agentID` string, uuid, required
- `scheduleID` string, uuid, required

## Response `200`

Schedule confirmed, or already confirmed (idempotent).

- Schedule
  - `id` string, uuid
  - `agent_id` string, uuid
  - `kind` 'once'
  - `status` 'awaiting_confirmation' | 'pending' | 'firing' | 'dispatched' | 'done' | 'cancelled' | 'failed': AI-client-created schedules await owner confirmation. done does not establish task success; inspect the run outcome.
  - `prompt` string
  - `fire_at` string, date-time
  - `thread_id` string
  - `metadata` object
  - `last_error` string
  - `attempts` integer
  - `created_at` string, date-time
  - `last_fired_at` string, date-time
  - `confirmed_at` string, date-time: Time the owner confirmed the schedule. Absent when unset.
  - `confirm_url` string, uri: Owner confirmation page. Present only for awaiting_confirmation schedules.

## Other responses

- `400`: Malformed request.
- `401`: Missing or invalid credential.
- `403`: AI clients cannot confirm; the error text includes the owner's confirmation link. Another account's agent is also forbidden.
- `404`: Agent or schedule not found, or schedule outside the addressed agent.
- `409`: Unconfirmed fire time has passed, the row's state cannot be confirmed and confirmed_at is unset, or the agent is being deleted (code: agent_deleting).
- `500`: Internal error.

---

[API](https://skmtc.dev/plori/apis/plori-rest-api.md) · [All operations](https://skmtc.dev/plori/apis/plori-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/plori/apis/plori-rest-api/revisions/2234a20f0150?raw)