Content Actions — API Reference

GET /actions/{contentTypeKey}/{contentId}/{actionId}/execute

Execute action

Execute a custom action defined on a content type for a specific content item. If the action has UseCallback enabled, returns an operationId and callbackUrl for async tracking. Otherwise, executes synchronously and returns the result.

Requires the ReadAccess policy

Path parameters

Name	Type	Description
`contentTypeKey`	string	The content type key
`contentId`	string	The content item ID (GUID)
`actionId`	string	The action identifier

Responses

200Success — action executed (sync) or accepted (async with callback)

`operationId`	string	Execution tracking ID (callback mode only)
`callbackUrl`	string	URL for the external service to report results (callback mode only)
`result`	object	Action-specific result data (sync mode only)

401Unauthorized

404Not Found — content or action does not exist

409Conflict — action is already running (callback mode, duplicate prevention)

Code examples

curl -X GET "https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/execute" \
  -H "X-Api-Key: YOUR_API_KEY"

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", "YOUR_API_KEY");

var response = await http.GetAsync("https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/execute");

response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

const response = await fetch(
  "https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/execute",
  {
    method: "GET",
    headers: {
      "X-Api-Key": "YOUR_API_KEY",
    }
  }
);

const data = await response.json();

import requests

headers = {"X-Api-Key": "YOUR_API_KEY"}

response = requests.get(
    "https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/execute",
    headers=headers
)

data = response.json()

Example request

GET /actions/Article/a1b2c3d4-e5f6-7890-abcd-ef1234567890/send-notification/execute

Example response 200

{
  "operationId": "d4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8",
  "callbackUrl": "https://api.contit.cloud/actions/callback/ws-123/d4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8"
}

Try it Live

API key or token

contentTypeKey string · required

contentId string · required

actionId string · required

GET /actions/{contentTypeKey}/{contentId}/{actionId}/navigate

Get navigation URL

Get a navigation URL for a custom action, typically used to redirect users to an external page or detail view.

Requires the ReadAccess policy

Path parameters

Name	Type	Description
`contentTypeKey`	string	The content type key
`contentId`	string	The content item ID (GUID)
`actionId`	string	The action identifier

Responses

200Success — returns a navigation URL

url string The navigation URL to redirect to

401Unauthorized

404Not Found

Code examples

curl -X GET "https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/navigate" \
  -H "X-Api-Key: YOUR_API_KEY"

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", "YOUR_API_KEY");

var response = await http.GetAsync("https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/navigate");

response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

const response = await fetch(
  "https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/navigate",
  {
    method: "GET",
    headers: {
      "X-Api-Key": "YOUR_API_KEY",
    }
  }
);

const data = await response.json();

import requests

headers = {"X-Api-Key": "YOUR_API_KEY"}

response = requests.get(
    "https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/navigate",
    headers=headers
)

data = response.json()

Example request

GET /actions/Product/b2c3d4e5-f6a7-8901-bcde-f12345678901/view-external/navigate

Example response 200

{
  "url": "https://shop.example.com/products/b2c3d4e5-f6a7-8901-bcde-f12345678901"
}

Try it Live

API key or token

contentTypeKey string · required

contentId string · required

actionId string · required

GET /actions/{contentTypeKey}/{contentId}/{actionId}/status

Get action execution status

Get the current execution status of a content action. Used to poll for completion when UseCallback is enabled.

Requires the ReadAccess policy

Path parameters

Name	Type	Description
`contentTypeKey`	string	The content type key
`contentId`	string	The content item ID (GUID)
`actionId`	string	The action identifier

Responses

200Success — returns execution status

`operationId`	string	Execution tracking ID
`status`	string	Execution status: Running (0), Succeeded (1), Failed (-1)
`result`	string	Result data (available when Succeeded)
`progress`	integer?	Progress percentage 0-100 (optional, set by external service)
`message`	string	Status message for display
`error`	string	Error details (available when Failed)
`updatedAt`	datetime	Last update timestamp

401Unauthorized

404Not Found — no execution record exists

Code examples

curl -X GET "https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/status" \
  -H "X-Api-Key: YOUR_API_KEY"

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", "YOUR_API_KEY");

var response = await http.GetAsync("https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/status");

response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

const response = await fetch(
  "https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/status",
  {
    method: "GET",
    headers: {
      "X-Api-Key": "YOUR_API_KEY",
    }
  }
);

const data = await response.json();

import requests

headers = {"X-Api-Key": "YOUR_API_KEY"}

response = requests.get(
    "https://api.contit.cloud/actions/{contentTypeKey}/{contentId}/{actionId}/status",
    headers=headers
)

data = response.json()

Example request

GET /actions/Article/a1b2c3d4-e5f6-7890-abcd-ef1234567890/send-notification/status

Example response 200

{
  "operationId": "d4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8",
  "status": "Running",
  "result": null,
  "progress": 50,
  "message": "Processing order items...",
  "error": null,
  "updatedAt": "2026-04-02T10:30:00Z"
}

Try it Live

API key or token

contentTypeKey string · required

contentId string · required

actionId string · required

POST /actions/callback/{workspaceId}/{operationId}

Action execution callback

Callback endpoint for external services (n8n, Zapier, etc.) to report action execution results. Does not require authentication — security is based on the unguessable operation ID. Send progress < 100 for intermediate updates, or set success to true/false for final completion.

Path parameters

Name	Type	Required	Description
`workspaceId`	string		The workspace ID
`operationId`	string		The operation ID returned by the execute endpoint

Request body application/json

Property	Type	Required	Description
`success`	boolean		true for success, false for failure
`result`	string	—	Result data returned to the client on success
`error`	string	—	Error message returned to the client on failure
`message`	string	—	Status message displayed in the UI
`progress`	integer?	—	Progress percentage (0-100). Values < 100 update progress without completing the action

Responses

200Success — status updated

404Not Found — operation does not exist or has expired

409Conflict — action has already completed

Code examples

curl -X POST "https://api.contit.cloud/actions/callback/{workspaceId}/{operationId}" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "success": true,
  "result": "result_value",
  "error": "error_value",
  "message": "message_value",
  "progress": "progress_value"
}'

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", "YOUR_API_KEY");

var content = new StringContent("{
  \"success\": true,
  \"result\": \"result_value\",
  \"error\": \"error_value\",
  \"message\": \"message_value\",
  \"progress\": \"progress_value\"
}",
    Encoding.UTF8, "application/json");
var response = await http.PostAsync(
    "https://api.contit.cloud/actions/callback/{workspaceId}/{operationId}", content);

response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

const response = await fetch(
  "https://api.contit.cloud/actions/callback/{workspaceId}/{operationId}",
  {
    method: "POST",
    headers: {
      "X-Api-Key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
  "success": true,
  "result": "result_value",
  "error": "error_value",
  "message": "message_value",
  "progress": "progress_value"
})
  }
);

const data = await response.json();

import requests

headers = {"X-Api-Key": "YOUR_API_KEY"}
payload = {
  "success": true,
  "result": "result_value",
  "error": "error_value",
  "message": "message_value",
  "progress": "progress_value"
}

response = requests.post(
    "https://api.contit.cloud/actions/callback/{workspaceId}/{operationId}",
    json=payload,
    headers=headers
)

data = response.json()

Example request

POST /actions/callback/ws-123/d4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8

{
  "success": true,
  "result": "Order processed successfully",
  "message": "Completed"
}

Try it Live

API key or token

workspaceId string · required

operationId string · required

Request body JSON