---
title: "Create Schedule"
method: POST
path: "/schedules/"
---

# Create Schedule

`POST /schedules/`

## Request

- Base URL: `https://client.apimetrics.io/api/2`
- URL: `https://client.apimetrics.io/api/2/schedules/`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/apicontext/apis/api-settings/docs/schedules/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this API to create a new Schedule.

## Request body

- object
  - `meta` object
    - `name` string: Name for identification
  - `tags` string[]: Tags for schedule
  - `schedule` object
    - `frequency` integer: How many seconds between each API call or workflow call when monitoring. For example, 600 is once every 10 minutes.
    - `regions` string[]: Regions to call from. For example, "all" for all locations, "na" for North America, etc..
    - `locations` string[]: List of specific locations to call from (we recommend you use regions instead)
  - `backoff_method` string: Optional backoff and retry method

## Response `201`

201

- object
  - `meta` object
    - `name` string
    - `created` string
    - `tags` unknown[]
      - unknown
    - `last_update` string
    - `owner` string
    - `project_id` string
  - `id` string
  - `schedule` object
    - `regions` string[]
    - `frequency` integer
    - `locations` unknown[]
      - unknown
    - `target_ids` unknown[]
      - unknown
    - `backoff_method` unknown

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/apicontext/apis/api-settings.md) - [All operations](https://skmtc.dev/apicontext/apis/api-settings/llms.txt) - [OpenAPI document](https://skmtc.dev/apicontext/apis/api-settings/revisions/2e9a62324e82?raw)