GenuineAIGenuineAI
For usersFor developers
  • Overview
  • Guides
  • How-to
  • API reference
Documentation
  • Quickstart
  • Authentication
  • Errors
  • Rate limits
  • API reference
Platform
  • Platform overview
  • Solutions
  • Pricing
  • Sign in
Company
  • Status
  • Trust Center
  • Contact
  • Terms of Service
  • Privacy Policy

© 2026 GenuineAI Ventures LLC

support@genuinehq.com
Overview
Core
Media library
AI
Documents
Knowledge
Creative
Website & content
Automation
    Workflows
    Workflow instances
    Tasks
    Scheduled jobs
      List scheduled jobsgetGet a scheduled jobgetSet a job overrideputDelete a job overridedeleteRun a job nowpostList job runsget
    Integrations
    Extensions
Customer channels
Administration
Schemas
GenuineAI API
GenuineAI API

Scheduled jobs

Recurring work the platform runs for a workspace: when each job runs, what a workspace changes about that, and what every run did.


List scheduled jobs

GET
https://api.genuineai.app/api/v1
/scheduled-jobs

Platform jobs with this workspace's overrides applied, plus its own jobs.

List scheduled jobs › query Parameters

cursor
​string · maxLength: 512 · pattern: ^[A-Za-z0-9_-]+$
job_scope
​string
job_title
​string
job_type
​string
limit
​integer
offset
​integer · min: 0
sort
​string · minLength: 1 · maxLength: 64 · pattern: ^-?[a-z0-9_]+$

List scheduled jobs › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

List scheduled jobs › Responses

Success

​ScheduledJob[] · required
has_more
​boolean · required

Whether more rows exist past this page.

next_cursor
​string | null · required

Pass back as cursor for the next page. Null on the last page.

GET/scheduled-jobs
curl https://api.genuineai.app/api/v1/scheduled-jobs \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
{ "data": [ { "job_id": "00000000-0000-0000-0000-000000000000", "job_managed_by": "job_managed_by", "job_active": true, "job_created": "2024-08-25T15:00:00Z", "job_updated": "2024-08-25T15:00:00Z", "job_name": "job_name", "job_title": "job_title", "job_description": "job_description", "job_cron": "job_cron", "job_timezone": "job_timezone", "job_type": "job_type", "job_workflow": "job_workflow", "job_config": {}, "job_scope": "job_scope", "job_max_retries": "job_max_retries", "job_timeout_seconds": "job_timeout_seconds", "job_metadata": {}, "override_id": "00000000-0000-0000-0000-000000000000", "override_enabled": true, "override_cron": "override_cron", "override_timezone": "override_timezone", "override_config": {}, "last_run_status": "last_run_status", "last_run_at": "2024-08-25T15:00:00Z" } ], "has_more": true, "next_cursor": "next_cursor" }
json
application/json

Get a scheduled job

GET
https://api.genuineai.app/api/v1
/scheduled-jobs/{id}

Returns one job with its schedule and what the workspace has changed about it.

Get a scheduled job › path Parameters

id
​string · uuid · required

Get a scheduled job › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Get a scheduled job › Responses

Success

Recurring work the platform runs for the workspace, and when it next runs.
ScheduledJob
job_id
​string · uuid
job_managed_by
​string
job_active
​boolean
job_created
​string · date-time
job_updated
​string · date-time
job_name
​string
job_title
​string
job_description
​string
job_cron
​string
job_timezone
​string
job_type
​string
job_workflow
​string
job_config
​object
job_scope
​string
job_max_retries
​string
job_timeout_seconds
​string
job_metadata
​object
override_id
​string · uuid
override_enabled
​boolean
override_cron
​string
override_timezone
​string
override_config
​object
last_run_status
​string
last_run_at
​string · date-time
GET/scheduled-jobs/{id}
curl https://api.genuineai.app/api/v1/scheduled-jobs/:id \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
{ "job_id": "00000000-0000-0000-0000-000000000000", "job_managed_by": "job_managed_by", "job_active": true, "job_created": "2024-08-25T15:00:00Z", "job_updated": "2024-08-25T15:00:00Z", "job_name": "job_name", "job_title": "job_title", "job_description": "job_description", "job_cron": "job_cron", "job_timezone": "job_timezone", "job_type": "job_type", "job_workflow": "job_workflow", "job_config": {}, "job_scope": "job_scope", "job_max_retries": "job_max_retries", "job_timeout_seconds": "job_timeout_seconds", "job_metadata": {}, "override_id": "00000000-0000-0000-0000-000000000000", "override_enabled": true, "override_cron": "override_cron", "override_timezone": "override_timezone", "override_config": {}, "last_run_status": "last_run_status", "last_run_at": "2024-08-25T15:00:00Z" }
json
application/json

Set a job override

PUT
https://api.genuineai.app/api/v1
/scheduled-jobs/{id}/override

Changes the schedule for this workspace only. The platform job is untouched.

Set a job override › path Parameters

id
​string · uuid · required

Set a job override › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Set a job override › Request Body optional

job_tenant_enabled
​boolean
job_tenant_cron
​string
job_tenant_timezone
​string

Set a job override › Responses

Success

No data returned
PUT/scheduled-jobs/{id}/override
curl https://api.genuineai.app/api/v1/scheduled-jobs/:id/override \ --request PUT \ --header 'Content-Type: application/json' \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>' \ --data '{ "job_tenant_enabled": true, "job_tenant_cron": "job_tenant_cron", "job_tenant_timezone": "job_tenant_timezone" }'
Example Request Body
{ "job_tenant_enabled": true, "job_tenant_cron": "job_tenant_cron", "job_tenant_timezone": "job_tenant_timezone" }
json
Example Responses
No example specified for this content type

Delete a job override

DELETE
https://api.genuineai.app/api/v1
/scheduled-jobs/{id}/override

The job goes back to the platform schedule.

Delete a job override › path Parameters

id
​string · uuid · required

Delete a job override › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Delete a job override › Responses

Success

No data returned
DELETE/scheduled-jobs/{id}/override
curl https://api.genuineai.app/api/v1/scheduled-jobs/:id/override \ --request DELETE \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

Run a job now

POST
https://api.genuineai.app/api/v1
/scheduled-jobs/{id}/run

Runs it for this workspace only, without affecting the schedule or anyone else.

Run a job now › path Parameters

id
​string · uuid · required

Run a job now › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Run a job now › Responses

Success

No data returned
POST/scheduled-jobs/{id}/run
curl https://api.genuineai.app/api/v1/scheduled-jobs/:id/run \ --request POST \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

List job runs

GET
https://api.genuineai.app/api/v1
/scheduled-jobs/{id}/runs

Returns what every run of this job did, newest first.

List job runs › path Parameters

id
​string · uuid · required

List job runs › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

List job runs › Responses

Success

No data returned
GET/scheduled-jobs/{id}/runs
curl https://api.genuineai.app/api/v1/scheduled-jobs/:id/runs \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

TasksIntegrations