Skip to main content
POST
Activate a trigger

Authorizations

Authorization
string
header
required

OAuth 2.0 authorization code flow with PKCE (S256). Discovery: https://api.guild.ai/.well-known/oauth-authorization-server.

Path Parameters

trigger_id
string<uuid>
required

Response

Successful response

id
string<uuid>
created_at
string<date-time>
updated_at
string<date-time>
agent_id
string<uuid>

The workspace agent to run when the trigger is activated.

name
string

Human-readable label identifying the trigger within its workspace.

Maximum string length: 255
workspace_id
string<uuid>
creator_id
string<uuid> | null

The actor (a user or an account API key) that created this trigger. Null for legacy rows created before creator attribution was recorded.

deactivated_at
string<date-time> | null

If set, indicates when the trigger has been deactivated.

type
enum<string>

Trigger type discriminator

Available options:
api
agent
object
workspace_agent
object