Routines
Get a routine
Retrieves the specified routine and its current configuration.
Koptekstparameters
Foundry-Features
enum
A feature flag opt-in required when using preview operations or modifying persisted preview resources.
Padparameters
routine_name
string
vereist
The unique name of the routine.
Queryparameters
api-version
string
vereist
The API version to use for this operation.
Antwoorden
The request has succeeded.
Hoofdtekst
name
string
The routine name.
description
string
A human-readable description of the routine.
enabled
boolean
vereist
Whether the routine is enabled.
triggers
object
The triggers configured for the routine.
[key: string]
schedule | timer | github_issue | custom
Base model for a routine trigger.
schedule
ScheduleRoutineTrigger
A recurring cron-based routine trigger.
type
enum
vereist
The trigger type.
cron_expression
string
vereist
A 5-field cron expression. The service enforces a minimum interval of five minutes by default.
time_zone
string
vereist
An IANA or Windows time zone identifier for the schedule.
timer
TimerRoutineTrigger
A one-shot timer routine trigger.
type
enum
vereist
The trigger type.
github_issue
GitHubIssueRoutineTrigger
A GitHub issue routine trigger.
type
enum
vereist
The trigger type.
connection_id
string
vereist
The workspace connection identifier that resolves the GitHub configuration for the trigger.
owner
string
vereist
The GitHub owner or organization that scopes which issues can fire the trigger.
repository
string
vereist
The GitHub repository filter that scopes which issues can fire the trigger.
issue_event
string | enum
vereist
Known GitHub issue events that can fire a routine.
enum
custom
CustomRoutineTrigger
A custom event routine trigger.
type
enum
vereist
The trigger type.
provider
string
vereist
The external provider that emits the custom event.
event_name
string
The provider-specific event name that fires the routine.
parameters
object
vereist
Provider-specific trigger parameters.
action
invoke_agent_responses_api | invoke_agent_invocations_api
Base model for a routine action.
invoke_agent_responses_api
InvokeAgentResponsesApiRoutineAction
Dispatches a routine through the responses API. Exactly one of agent_name or agent_endpoint_id must be provided.
type
enum
vereist
The action type.
agent_name
string
The project-scoped agent name for routine dispatch.
agent_endpoint_id
string
Legacy endpoint-scoped agent identifier for routine dispatch.
input
InvokeAgentResponsesApiRoutineAction
Static JSON value sent as the complete downstream input when the routine fires. The value is passed through as-is; no templating is applied.
conversation
string
An optional existing conversation identifier to continue during the downstream dispatch.
invoke_agent_invocations_api
InvokeAgentInvocationsApiRoutineAction
Dispatches a routine through the raw invocations API. Exactly one of agent_name or agent_endpoint_id must be provided.
type
enum
vereist
The action type.
agent_name
string
The project-scoped agent name for routine dispatch.
agent_endpoint_id
string
Legacy endpoint-scoped agent identifier for routine dispatch.
input
InvokeAgentInvocationsApiRoutineAction
Static JSON value sent as the complete downstream input when the routine fires. The value is passed through as-is; no templating is applied.
session_id
string
An optional existing hosted-agent session identifier to continue during the downstream dispatch.
Aanvraag
GET /routines/{routine_name} HTTP/1.1Respons
Status: 200
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json