Get a scheduled report

GET/scheduledReports/{scheduledReportId}

Base URL: https://api.tinkermode.com

Return the scheduled report with the specified ID.

Authentication

Send an Authorization header of the form ModeCloud <AUTH_CODE>.

Must contain the key of a user or service account with permissions to read scheduled reports, or a project API key.

Path parameters

NameTypeRequiredConstraintsDescription
scheduledReportIdintegerYesThe unique ID for a specific scheduled report.

Responses

200 Successfully retrieved the specified scheduled report.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
answerEngineobjectYes
Properties of answerEngine
PropertyTypeRequiredConstraintsDescription
assistantIdintegerYesID of the assistant to use for generating answers
maxConcurrentCallsintegerNodefault: 4Maximum number of concurrent calls to the assistant
contentsstringYesYAML configuration for report sections
creationTimestringNoformat: date-timeWhen the report was created
descriptionstringNoDescription of the scheduled report
directDestinationarray<object>NoDirect rooms to send the report to
Properties of directDestination
PropertyTypeRequiredConstraintsDescription
idstringYesDirect room ID
namestringNoDirect room name
enabledbooleanNoWhether the scheduled report is enabled
idintegerYesUnique identifier for the scheduled report
projectIdintegerYesID of the project this report belongs to
reportScheduleobjectYes
Properties of reportSchedule
PropertyTypeRequiredConstraintsDescription
expressionstringYesSchedule expression (e.g., cron expression)
timeZonestringNoTimezone for the schedule
typestringYesType of schedule (e.g., cron)
slackDestinationarray<object>NoSlack channels to send the report to
Properties of slackDestination
PropertyTypeRequiredConstraintsDescription
idstringYesSlack channel ID
namestringNoSlack channel name
teamsDestinationarray<object>NoMS Teams channels to send the report to
Properties of teamsDestination
PropertyTypeRequiredConstraintsDescription
idstringYesMS Teams channel ID
namestringNoMS Teams channel name
titlestringYesTitle of the scheduled report
updateTimestringNoformat: date-timeWhen the report was last updated

401 Authorization is required to access this resource.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
dataobjectNoread-only (server-generated)Any relevant data related to error.
reasonstringYesread-only (server-generated)Reason of error.

403 Request failed because of denied permission.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
dataobjectNoread-only (server-generated)Any relevant data related to error.
reasonstringYesread-only (server-generated)Reason of error.

404 Scheduled report not found.

429 Request failed because of rate limit.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
dataobjectNoread-only (server-generated)Any relevant data related to error.
reasonstringYesread-only (server-generated)Reason of error.

500 An unexpected error has occurred.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
dataobjectNoread-only (server-generated)Any relevant data related to error.
reasonstringYesread-only (server-generated)Reason of error.

503 The service is temporarily unavailable.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
dataobjectNoread-only (server-generated)Any relevant data related to error.
reasonstringYesread-only (server-generated)Reason of error.