---
title: "AgentListPull"
method: POST
path: "/agents/pull"
tags: ["AgentListPull"]
---

# AgentListPull

`POST /agents/pull`

## Headers

- `Api-Version` 2, required
- `Api-Application` string, required
- `Api-Company` string, required
- `Api-Branding` string

## Request body

- object[]
  - `device` string, required
  - `pullCode` string, required
  - `groups` object[]
    - `publicId` string
  - `forced` boolean

## Response `201`

Success response. Data could be an object instead of a list when one value is returned

- object
  - `status` string, required
  - `type` string, required
  - `moreAfter` string, nullable
  - `data` object[], required
    - `publicId` string, required

## Other responses

- `4XX` — 4XX error response

---

[API](https://skmtc.net/ixon/apis/ixon-api.md) · [All operations](https://skmtc.net/ixon/apis/ixon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ixon/ixon-api/revisions/7875dc33d41f/schema)