Skip to main content
GET
/
v1
/
actions
/
{action_id}
Get a Specific Action by ID
curl --request GET \
  --url https://api.trata.ai/v1/actions/{action_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "act.1234567890",
  "orgId": "org.1234567890",
  "name": "Webhook on call completion.",
  "description": "This action will be invoked when a call is completed. It will send a webhook to the specified url.",
  "parameters": {},
  "endpoint": {
    "url": "https://webhook-endpoint.com",
    "method": "POST"
  },
  "invocationTrigger": "webhook.conversation_en",
  "userWaitingText": "Please wait...",
  "userSuccessText": "Action completed successfully",
  "userErrorText": "An error occurred",
  "createdBy": "usr.1234567890",
  "createdAt": "2024-12-06T19:23:38.616711",
  "updatedBy": "usr.1234567890",
  "updatedAt": "2024-12-06T19:23:38.616714"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
action_id
string
required

ID of the action

Response

Action retrieved successfully

Action entity to store the actions which can be performed by ai agents

​
id
string
​
orgId
string
​
name
string
​
description
string | null
​
parameters
object | null
​
endpoint
object | null
​
invocationTrigger
string | null
​
userWaitingText
string | null
​
userSuccessText
string | null
​
userErrorText
string | null
​
createdBy
string
​
createdAt
string<date-time>
​
updatedBy
string
​
updatedAt
string<date-time>