/v1/facilities/{facility_id}/report-schedulesAuthentication
Bearer API key or Facily session, subject to permissions and facility scope.
Authentication and scopeRequest example
Replace bracketed path values with real IDs from your environment. The body, where shown, is generated from the schema and uses illustrative values.
curl --request GET \
--url 'https://api.staging.facily.ai/v1/facilities/<FACILITY_ID>/report-schedules' \
--header "Authorization: Bearer $FACILY_API_KEY"Try a request
Staging · read-onlyExplore your organization with a read-only request to staging.
Parameters
facility_idpath · string | stringrequiredFormat: uuid
Responses
Expand a status to inspect its schema. Generated examples show structure and synthetic values.
200Successful Response
{
"data": [
{
"cadence": "daily",
"can_manage": false,
"can_take_over": false,
"consecutive_failures": 0,
"created_at": "2026-10-29T12:00:00Z",
"definition_key": "string",
"format": "csv",
"id": "00000000-0000-4000-8000-000000000001",
"local_time": "string",
"needs_owner": false,
"next_run_at": "2026-10-29T12:00:00Z",
"next_run_local": "string",
"owner": {
"display_name": "string",
"id": "00000000-0000-4000-8000-000000000001"
},
"starts_on": "2026-10-29",
"status": "active",
"timezone": "string",
"updated_at": "2026-10-29T12:00:00Z",
"view_key": "string"
}
],
"meta": {
"request_id": "string"
}
}application/json
dataReportScheduleResponse[]requiredShow data schema
cadencestringrequiredHow often it runs.
Values: "daily", "weekly", "monthly", "quarterly"
can_managebooleanrequiredWhether the caller may edit, pause, resume or end it.
can_take_overbooleanrequiredWhether the caller may take it over.
card_namestring | nullThe report's name; null for a report retired since.
Show card_name schema
string | nullThe report's name; null for a report retired since.
Variant 1: string
stringVariant 2: null
nullconsecutive_failuresintegerrequiredFailed runs in a row.
created_atstringrequiredWhen the schedule was created.
Format: date-time
definition_keystringrequiredThe report's key.
facility_idstring | nullThe facility; null for all facilities.
Format: uuid
Show facility_id schema
string | nullThe facility; null for all facilities.
Variant 1: string
stringVariant 2: null
nullfacility_namestring | nullThe facility's name; null for all facilities.
Show facility_name schema
string | nullThe facility's name; null for all facilities.
Variant 1: string
stringVariant 2: null
nullfiltersobjectThe view's filters, as stored.
formatstringrequiredThe file the emailed link opens first.
Values: "csv", "xlsx", "pdf", "zip"
idstringrequiredThe schedule's id.
Format: uuid
last_runReportScheduleLastRunResponse | nullThe most recent run; null before the first.
Show last_run schema
ReportScheduleLastRunResponse | nullThe most recent run; null before the first.
Variant 1: ReportScheduleLastRunResponse
completed_atstring | nullWhen the run completed or failed.
Format: date-time
Show completed_at schema
string | nullWhen the run completed or failed.
Variant 1: string
Variant 2: null
error_messagestring | nullWhy the run failed, for the reader. It holds no value.
Show error_message schema
string | nullWhy the run failed, for the reader. It holds no value.
Variant 1: string
Variant 2: null
idstringrequiredThe run's id.
Format: uuid
statusstringrequired`queued`, `running`, `completed` or `failed`.
Values: "queued", "running", "completed", "failed"
Variant 2: null
nulllocal_timestringrequired`HH:MM` in `timezone`.
month_dayinteger | null1 to 28, or -1 for the last day, for a monthly or quarterly one.
Show month_day schema
integer | null1 to 28, or -1 for the last day, for a monthly or quarterly one.
Variant 1: integer
integerVariant 2: null
nullneeds_ownerbooleanrequiredTrue when the owner can no longer run this report here: a member may take it over.
next_run_atstringrequiredThe next run's moment, in UTC.
Format: date-time
next_run_localstringrequiredThe next run's date and time in `timezone`, ISO with no offset (`2026-11-02T06:00:00`).
notesstring | nullNotes for the members.
Show notes schema
string | nullNotes for the members.
Variant 1: string
stringVariant 2: null
nullownerReportMemberResponserequiredA member of the organization as the schedule routes name one: id and display name only, never an address or a role (framework 12.1).
Show owner schema
display_namestringrequiredThe member's name, as the team list shows it.
idstringrequiredThe member's user id.
Format: uuid
pause_reasonstring | nullWhy a paused schedule is paused: `manual`, `no_recipients` (no recipient could receive it), `report_locked` (the report became unavailable) or `failing` (three failed runs in a row).
Values: "manual", "no_recipients", "report_locked", "failing"
Show pause_reason schema
string | nullWhy a paused schedule is paused: `manual`, `no_recipients` (no recipient could receive it), `report_locked` (the report became unavailable) or `failing` (three failed runs in a row).
Variant 1: string
stringValues: "manual", "no_recipients", "report_locked", "failing"
Variant 2: null
nullrange_rulestring | nullThe named range each run reports; null for a view that takes no dates.
Show range_rule schema
string | nullThe named range each run reports; null for a view that takes no dates.
Variant 1: string
stringVariant 2: null
nullrecipientsReportMemberResponse[]Who receives the link.
Show recipients schema
display_namestringrequiredThe member's name, as the team list shows it.
idstringrequiredThe member's user id.
Format: uuid
starts_onstringrequiredNo run happens before this day.
Format: date
statusstringrequired`active` or `paused`.
Values: "active", "paused"
timezonestringrequiredThe schedule's timezone: its facility's, or for all the first facility's.
updated_atstringrequiredWhen it last changed.
Format: date-time
view_keystringrequiredThe view's key.
view_namestring | nullThe view's name; null for a view retired since.
Show view_name schema
string | nullThe view's name; null for a view retired since.
Variant 1: string
stringVariant 2: null
nullweekdayinteger | null1 (Monday) to 7 (Sunday) for a weekly schedule.
Show weekday schema
integer | null1 (Monday) to 7 (Sunday) for a weekly schedule.
Variant 1: integer
integerVariant 2: null
nullmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired400Validation error
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired401Unauthenticated
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired403Permission denied
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired404Not found
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired409Business logic error
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired503Temporary failure
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired