Delete schedule
Learn more about delete schedule.
Use the Delete schedule to delete a schedule. This lets you remove a schedule that is no longer needed so it no longer runs.
HTTP method and endpoint
Use the following HTTP method and endpoint path to delete schedule.
DELETE {TenantURL}/ai/agentflow/api/v202605/{tenant_id}/schedules/{schedule_id}
The following table describes the endpoint path parameters.
| Parameter | Type | Required | Description |
|---|---|---|---|
TenantURL | String | Yes | The base URL for your tenant. |
tenant_id | String | Yes | The unique identifier of your tenant. |
schedule_id | String | Yes | The unique identifier of the schedule. |
Request headers
The following request headers must be included.
| Header | Value | Required |
|---|---|---|
Authorization | <access_token> | Yes |
Request body
This operation does not require a request body.
Example request
Use the following example to see how a complete request is structured, with headers.
DELETE {TenantURL}/ai/agentflow/api/v202605/tenant-xyz/schedules/example-id
Authorization: <access_token>
Response body
This operation does not return a response body. A successful request returns 204 with no content.
Error codes and recommended actions
The following table lists the possible error responses returned by this API.
| HTTP status | Description | Recommended action |
|---|---|---|
422 Unprocessable Entity | Validation Error | Review the request parameters or body, correct the invalid values, and resend the request. |