Skip to main content
POST
/
v1
/
actions
Create growth action
curl --request POST \
  --url https://api.flokit.ai/v1/actions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspace_id": "<string>",
  "type": "<string>",
  "reason": "<string>"
}
'
Create a proposed action for review in the FloKit action queue.
This endpoint is a placeholder for documentation structure only. Update the path, request schema, and response schema when the production API is finalized.

Request body

workspace_id
string
required
Workspace that should own the action.
type
string
required
Action type, such as shift_budget, pause_creative, or prepare_offer_test.
reason
string
Human-readable explanation for why the action is being proposed.

Example request

curl -X POST https://api.flokit.ai/v1/actions \
  -H "Authorization: Bearer $FLOKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "workspace_123",
    "type": "shift_budget",
    "reason": "Creative A has weaker renewal quality than Creative B in the same country."
  }'

Example response

{
  "id": "action_123",
  "status": "ready_for_approval"
}