Automation configurations

Manage automation configs and review automation activity.

All requests require an API key.

Headers

X-API-KEY: {{API_KEY}}

Common query parameter

Most endpoints require:

• agent_id (string) — the agent identifier

?agent_id={{AGENT_ID}}

Get automation configs

Retrieve automation configurations for an agent.

GET /api/v1/aura_automations/configs?agent_id={{AGENT_ID}}
X-API-KEY: {{API_KEY}}

Response

[
  {
    "id": 1,
    "agent_id": "agent_123",
    "automation_type": "warm_up",
    "platform": "tiktok",
    "frequency": "daily",
    "duration": "30_minutes",
    "start_time": "09:00",
    "end_time": "10:00",
    "comment_prompt": "Write a friendly comment",
    "comment_review": true
  }
]

Create automation config

Create a new automation configuration.

POST /api/v1/aura_automations/configs?agent_id={{AGENT_ID}}
X-API-KEY: {{API_KEY}}
Content-Type: application/json

{
  "data": {
    "automation_type": "warm_up",
    "platform": "tiktok",
    "frequency": "daily",
    "duration": "30_minutes",
    "start_time": "09:00",
    "end_time": "10:00",
    "comment_prompt": "Write a friendly comment about this video",
    "comment_review": true
  }
}

Errors

• 400 invalid_time_format: time must be HH:MM

• 400 invalid_time_range: start_time must be before end_time

• 400 time_out_of_range: time must be between 00:00 and 23:59

Update automation config

Update an existing automation configuration.

PUT /api/v1/aura_automations/configs/{{CONFIG_ID}}?agent_id={{AGENT_ID}}
X-API-KEY: {{API_KEY}}
Content-Type: application/json

{
  "data": {
    "start_time": "10:00",
    "end_time": "11:00"
  }
}

Errors

• 400 Validation error: invalid time format, invalid time range, or time out of range

Delete automation config

Delete an automation configuration.

DELETE /api/v1/aura_automations/configs/{{CONFIG_ID}}?agent_id={{AGENT_ID}}
X-API-KEY: {{API_KEY}}

Get activity logs

Retrieve automation activity logs.

GET /api/v1/aura_automations/activity_logs?agent_id={{AGENT_ID}}
X-API-KEY: {{API_KEY}}

Response

{
  "activities": [
    {
      "id": 1,
      "agent_id": "agent_123",
      "activity_type": "comment",
      "status": "completed",
      "video_url": "https://tiktok.com/video/123",
      "comment_text": "Great video!",
      "created_at": "2024-01-01T00:00:00Z"
    }
  ]
}

Update activity comment

Update comment for a specific activity.

PUT /api/v1/aura_automations/activity_logs/{{ACTIVITY_ID}}/comment?agent_id={{AGENT_ID}}
X-API-KEY: {{API_KEY}}
Content-Type: application/json

{
  "comment": "Updated comment text"
}

Errors

• 400 Activity not found, agent mismatch, or activity status/type not eligible

Approve and post comment

Approve and post a comment for an activity.

POST /api/v1/aura_automations/activity_logs/{{ACTIVITY_ID}}/approve?agent_id={{AGENT_ID}}
X-API-KEY: {{API_KEY}}

Errors

• 400 activity_not_found: activity not found or agent mismatch

• 400 missing_details: missing video or comment details

• 400 invalid_status: activity status or type is ineligible