---
title: "Create a schedule for an agent"
method: POST
path: "/v1/agents/{workflow_permanent_id}/schedules"
tags: ["Schedules"]
---

# Create a schedule for an agent

`POST /v1/agents/{workflow_permanent_id}/schedules`

## Path parameters

- `workflow_permanent_id` string, required

## Headers

- `x-api-key` string, nullable — Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

## Request body

- WorkflowScheduleUpsertRequest
  - `cron_expression` string, required
  - `timezone` string, required
  - `enabled` boolean, nullable
  - `parameters` object, nullable
  - `name` string, nullable
  - `description` string, nullable

## Response `200`

Successful Response

- WorkflowScheduleResponse
  - `schedule` WorkflowSchedule, required
    - `workflow_schedule_id` string, required
    - `organization_id` string, required
    - `workflow_permanent_id` string, required
    - `cron_expression` string, required
    - `timezone` string, required
    - `enabled` boolean, required
    - `parameters` object, nullable
    - `temporal_schedule_id` string, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `created_at` string, date-time, required
    - `modified_at` string, date-time, required
    - `deleted_at` string, date-time, nullable
  - `next_runs` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/skyvern-ai/apis/skyvern-api-2.md) · [All operations](https://skmtc.net/skyvern-ai/apis/skyvern-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api-2/versions/29562c6e0364/schema)