Retry a failed activation item

POST

/integration/v1/organizations/{organization}/geofences/{uuid}/activations/{batch}/items/{item}/retry

curl --request POST \
  --url https://api.elwids.xyz/api/integration/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/geofences/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/activations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/items/1/retry \
  --header 'Authorization: Bearer <token>'

Requires: geofences:activate and geofences:manage

Rate limits: 240 a minute per address, 60 a minute per application

Starts a new workflow deployment for one failed item and returns the activation. Needs geofences:activate and geofences:manage. 403 when the geofence has an assignment outside the application’s grant; 409 when the item has not failed; 422 when the runtime rejects the activation (under errors.runtime).

Authorizations

• applicationToken

Parameters

Path Parameters

organization

required

string format: uuid

The organization UUID. A value that does not match returns 404.

uuid

required

string format: uuid

A value that does not match returns 404.

batch

required

string format: uuid

A value that does not match returns 404.

item

required

integer

A value that does not match returns 404.

Responses

200

The activation, with the item pending again.

Media typeapplication/json

object

data

required

The activation of one geofence revision: one item per assignment to activate or remove. Poll it until status is no longer pending.

object

uuid

required

The operation_uuid the client sent.

string format: uuid

geofence_revision

required

integer

>= 1

status

required

string

Allowed values: pending partial_failure succeeded

created_at

required

string format: date-time

updated_at

required

string format: date-time

items

required

Array<object>

object

id

required

Pass as item to retry a failed item.

integer

>= 1

assignment_uuid

required

string format: uuid

device_uuid

required

string format: uuid

operation_uuid

required

The workflow deployment that applies this item.

string format: uuid

target

required

string

Allowed values: active inactive

status

required

pending, succeeded or failed, following the workflow deployment.

string

diagnostic

required

string | null

Example

{
  "data": {
    "uuid": "9f8e7d6c-5b4a-4392-8170-6f5e4d3c2b1a",
    "geofence_revision": 1,
    "status": "pending",
    "created_at": "2026-10-12T08:00:00.000000Z",
    "updated_at": "2026-10-12T08:05:00.000000Z",
    "items": [
      {
        "id": 41,
        "assignment_uuid": "4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
        "device_uuid": "3f8a1c2e-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
        "operation_uuid": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
        "target": "active",
        "status": "pending",
        "diagnostic": null
      }
    ]
  }
}

Headers

Cache-Control

required

string

/(^|[ ,])no-store([ ,]|$)/

Responses to authenticated integration requests are never cached. The header also carries private.

Example

no-store, private

401

No valid credentials: no session (first-party API), or a missing, invalid, expired or revoked application token (integration API).

Media typeapplication/json

The body of most error responses.

object

message

required

string

Example ^generated

{
  "message": "example"
}

403

The caller is not allowed: not a member of the organization, missing a tenant or platform permission, or (integration API) an ability not granted on both the application and the token.

Media typeapplication/json

The body of most error responses.

object

message

required

string

Example ^generated

{
  "message": "example"
}

404

Not found: an unknown organization or resource, a resource in another organization or not granted to the application, or a malformed identifier (the route does not match).

Media typeapplication/json

The body of most error responses.

object

message

required

string

Example ^generated

{
  "message": "example"
}

409

The request conflicts with the current state, for example a stale revision.

Media typeapplication/json

The body of most error responses.

object

message

required

string

Example ^generated

{
  "message": "example"
}

422

The input failed validation.

Media typeapplication/json

422 for input that failed validation.

object

message

required

The first error, followed by a count of the others.

string

errors

required

Messages per field, keyed by the field’s dotted path. A rejection by the device runtime appears under runtime.

object

runtime

Array<string>

key

additional properties

Array<string>

Example ^generated

{
  "message": "example",
  "errors": {
    "runtime": [
      "example"
    ]
  }
}

429

A rate limit was reached; see x-rate-limits on the operation.

Media typeapplication/json

The body of most error responses.

object

message

required

string

Example ^generated

{
  "message": "example"
}

Headers

Retry-After

required

integer

Seconds to wait before retrying.