API v1 Reference › Agent Schedules

Lists owned schedules.

GEThttps://api.awork.com/api/v1/agents/schedules/me
GET https://api.awork.com/api/v1/agents/schedules/me

Lists schedules owned by the requesting user whose active agents remain readable. The overview processes the newest 1,000 owned schedules.

Authentication

AuthorizationBearer

Send your token in the Authorization: Bearer <token> header. See Authentication for API keys and OAuth.

Responses

200 OK

application/json

namestring or nullOptional

The schedule display name.

idstringOptional
format: uuid

The schedule id.

createdOnstringOptional
format: date-time

When the schedule was created.

agentIdstring or nullOptional
format: uuid

The agent id that is executed by this schedule.

typestring or nullOptional

Runtime target type: personal-agent or custom-agent.

ownerUserIdstringOptional
format: uuid

The user id whose context is used to execute the scheduled run.

promptstring or nullOptional

Optional custom instructions. An omitted or null prompt means no custom instructions.

cronRulestring or nullOptional

The normalized cron rule used for recurring execution.

recurrenceIntervalintegerOptional
format: int32

The number of matching cron occurrences between scheduled runs.

timezonestring or nullOptional

The timezone used to evaluate the cron rule.

projectIdstring or nullOptional
format: uuid

The optional project context id.

taskIdstring or nullOptional
format: uuid

The optional task context id.

isTaskContextDeletedbooleanOptional

Whether the required task context was deleted.

isEnabledbooleanOptional

Whether this schedule is active.

needsAttentionbooleanOptional

Whether the schedule needs user attention.

lastFailureReasonstring or nullOptional

The latest rejection reason.

consecutiveFailureCountintegerOptional
format: int32

The number of consecutive failed scheduled executions.

lastAttemptOnstring or nullOptional
format: date-time

The latest occurrence time.

lastSuccessfulRunOnstring or nullOptional
format: date-time

The latest accepted occurrence time.

Search documentation