Agents
Update an agent
Updates an agent and returns the full object. Triggers replace the complete saved set and re-sync Temporal schedules; omit triggers to keep them unchanged.
patchhttps://api.govdash.us/v1/agents/{id}
Authorization
Your API key as a bearer token, for example Bearer gd_live_....
See Authentication for how to create a key.
Path parameters
Headers
The dated API version this request is written against. Responses keep that version's shape after newer versions ship.
One of:
Body
application/jsonFields to update; omitted fields retain their values.
One of:
One of:
Full replacement trigger set. An empty array removes all triggers and their schedules. SCHEDULE requires cron_expression and timezone.
Show child attributesHide child attributes
One of:
Show child attributesHide child attributes
Show child attributesHide child attributes
One of:
Response
200 · application/jsonWhen the agent was created.
When the agent was last updated.
One of:
One of:
Show child attributesHide child attributes
One of:
Show child attributesHide child attributes
One of:
Errors
Every error returns a stable error.code to branch on and an error.message that says what went wrong, like the examples below. See Errors for how to handle each one.
The body is empty, has a field this endpoint doesn't accept, or a field has the wrong type. The message names the field.
Invalid request body: Expected a value with at least 1 entry
The key's service account doesn't have the permission this needs, or your team's access has ended.
You do not have permission to perform this action.
The record doesn't exist, belongs to another team, or is above the key's classification.
The requested resource was not found.
The request is well formed, but GovDash won't make this change. The message says why, when it can.
The request failed validation.
You sent too many requests. Wait the seconds in the retry-after header, then retry.
This access token exceeded its write rate limit.
Something went wrong on GovDash's side, usually a bug. Retry with backoff, and check before retrying a create.
An unexpected error occurred.
GovDash is briefly unavailable and didn't run the request. Retry after retry-after.
The service is temporarily unavailable. Try again later.