Ricky logorickyDocs

Set the header file of a scheduled workflow

POST
/workflows/{workflow_id}/header-media

Downloads the file at url and stores it as the header every send of a scheduled workflow carries, replacing the previous one. The workflow’s template must have an image, video or document header, and the file must be that kind. Answers the workflow, with has_header_image true.

Scope: workflows:write.

Authorization

bearerAuth
headerAuthorizationBearer <token>

An organization API key, rky_live_…, created in Settings → API. Send it only from a server.

Path Parameters

workflow_id*string

Workflow ID.

Formatuuid

Header Parameters

Idempotency-Key?string

Optional. A value you choose, unique per logical write, 8–200 characters: a UUID or an ID from your system such as order-10482-ready. Retrying with the same key and body replays the first response instead of repeating the write.

Length8 <= length <= 200

Request Body

application/json
  1. body

The file every send of the workflow carries in its template header.

url*string

Public HTTPS address Ricky downloads the file from. It must not redirect or resolve to a private address, and its Content-Type must be the kind the template header takes (image, video or document) within WhatsApp’s size limit for it.

Formaturi
Lengthlength <= 2048
file_name?string

Name to keep for the file; defaults to the last part of the URL.

Length1 <= length <= 240

Response Body

Success.

application/json
  1. response
data*

An automation Ricky runs for the organization.

curl -X POST 'https://getricky.ai/api/v1/workflows/497f6eca-6276-4993-bfeb-53cbbbba6f08/header-media' \  -H 'Idempotency-Key: order-10482-ready' \  -H 'Content-Type: application/json' \  -d '{  "url": "https://example.com/recordatorio.jpg"}'
{  "data": {    "id": "a3b4c5d6-e7f8-4a9b-8c0d-2e3f4a5b6c7d",    "name": "Fuera de horario",    "status": "active",    "type": "conversation",    "definition": {      "trigger": "conversation_opened",      "channel_ids": [        "8f3c2a5e-6b1d-4c7a-9e2f-1a2b3c4d5e6f"      ],      "condition": {        "kind": "outside_business_hours",        "business_hours": {          "start": "09:00",          "end": "18:00",          "timezone": "America/Panama",          "weekdays": [            1,            2,            3,            4,            5          ]        }      },      "flow": {        "entry": "bienvenida",        "steps": [          {            "id": "bienvenida",            "kind": "send_message",            "text": "Hola, gracias por escribir a Casa Nativa. Abrimos de lunes a viernes de 9:00 a 18:00.",            "next": "motivo"          },          {            "id": "motivo",            "kind": "ask_question",            "text": "¿En qué te ayudamos?",            "answer_key": "motivo",            "choices": [              {                "id": "pedido",                "label": "Mi pedido",                "next": "asesor"              },              {                "id": "otro",                "label": "Otra consulta",                "next": "agente"              }            ],            "timeout_seconds": 3600,            "on_timeout": "agente",            "on_invalid": "agente",            "next": "agente"          },          {            "id": "asesor",            "kind": "assign_user",            "user_id": "2d4f6a8c-1b3d-4e5f-8a7b-9c0d1e2f3a4b",            "next": null          },          {            "id": "agente",            "kind": "assign_agent",            "agent_id": "7e8f9a0b-1c2d-4e3f-a4b5-c6d7e8f9a0b1",            "next": null          }        ]      }    },    "updated_at": "2026-10-14T15:30:00.000Z"  }}