Aktywuj podróż

Aktywuj lub wstrzymaj istniejącą podróż.

POST/journeys/{id}/activatejourneys:write

ZACHOWANIE

Zmiana zostanie zweryfikowana i utrwalona na koncie kluczowym przed udzieleniem odpowiedzi. Zapytaj zwrócony zasób jako źródło prawdy.

EFEKT

Może zmienić zasób i wyemitować odpowiednie zdarzenie domeny.

POWTÓRKA

W przypadku awarii sieci potwierdź stan zasobu przed ponowną próbą. Automatycznie ponawiaj tylko 429 i 5xx z cofaniem i jitterem.

Żądanie

idstring · pathIdentyfikator zasobu.minLength 2 · maxLength 100obowiązkowe

activeboolean · bodypożądany stan; domyślnie prawda.opcjonalne

AuthorizationBearer ach_live_...

Acceptapplication/json

Zakresjourneys:write

Przykład wykonywalny

curl

curl -X POST 'https://achadu.com/api/v1/journeys/resource_id/activate' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "active": true
}'

Odpowiedź i błędy

Każda odpowiedź zawiera request_id. Listy dodają paginację; zasoby modyfikowalne zwracają utrwalony stan po operacji.

200 application/json

{
  "data": {
    "id": "jrn_01J...",
    "name": "Recover interest",
    "trigger": "conversation.updated",
    "blocks": [],
    "active": 1,
    "executions": 42
  },
  "request_id": "req_01J..."
}

200Operacja zakończona.

400Nieprawidłowy parametr, treść lub przejście.

401Brakujący, nieprawidłowy, wygasły lub unieważniony klucz.

402Plan konta nie udostępnia tego interfejsu.

403A chave precisa do escopo journeys:write.

404Funkcja nie istnieje na tym koncie.

409Obecny stan uniemożliwia tę operację.

413Treść JSON przekracza 128 KB.

429Przekroczono okno 120 żądań na minutę.

Aktywuj podróż

Żądanie

Przykład wykonywalny

Odpowiedź i błędy

Powiązane operacje