Read a geofence activation

GET

/integration/v1/organizations/{organization}/geofences/{uuid}/activations/{batch}

curl --request GET \
  --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 \
  --header 'Authorization: Bearer <token>'

Requires: geofences:read

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

The activation batch a save returned, with each item’s status taken from its workflow deployment. Poll until status is succeeded or partial_failure. 403 when the geofence has an assignment outside the application’s grant.

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.

Responses

200

The activation.

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": "partial_failure",
    "created_at": "2026-10-12T08:00:00.000000Z",
    "updated_at": "2026-10-12T08:00:05.000000Z",
    "items": [
      {
        "id": 41,
        "assignment_uuid": "4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
        "device_uuid": "3f8a1c2e-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
        "operation_uuid": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
        "target": "active",
        "status": "failed",
        "diagnostic": "Activate against the currently applied device configuration and generation."
      }
    ]
  }
}

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"
}

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.