> For the complete documentation index, see [llms.txt](https://docs.nected.ai/nected-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nected.ai/nected-docs/management-api/audit-log-api/pull-remote-data.md).

# Pull Remote Data

`POST /dev/v1/remote/pull`

Swagger **summary** text says “Get auditLog search result.” The published **`response`** schema in **`swagger-doc.json`** wraps **`data`** as **`response.PullResponse`**: `taskId` and `taskState` (async task tracking), not an audit search payload. Treat the summary line as potentially stale; rely on **`PullResponse`** for client code.

### Authentication

| Header           | Type   | Required | Description                                                                 |
| ---------------- | ------ | -------- | --------------------------------------------------------------------------- |
| `Nected-API-Key` | string | Yes      | Your Nected API key.                                                        |
| `Nected-Branch`  | string | No       | Branch name (optional in Swagger; use when the operation is branch-scoped). |

## Get auditLog search result.

> Published summary from Swagger. \*\*Response \`data\`\*\* is \*\*\`PullResponse\`\*\* (\`taskId\`, \`taskState\`) for tracking an asynchronous operation.\
> \
> Send \*\*\`Nected-API-Key\`\*\* (via \*\*DevAuth\*\*) and optionally \*\*\`Nected-Branch\`\*\* (branch name).

```json
{"openapi":"3.0.3","info":{"title":"Nected Dev V1 — Remote pull","version":"1.0"},"tags":[{"name":"DevV1","description":"Development workspace APIs (API key auth)."}],"servers":[{"url":"https://api.nected.ai","description":"Production"}],"security":[{"DevAuth":[]}],"components":{"securitySchemes":{"DevAuth":{"type":"apiKey","in":"header","name":"Nected-API-Key","description":"Dev API key"}},"schemas":{"Response":{"type":"object","description":"Standard API wrapper (`response.Response` in Swagger 2 definitions).","properties":{"code":{"type":"string"},"message":{"type":"string"},"data":{"type":"object","nullable":true},"pageNo":{"type":"integer"},"pageSize":{"type":"integer"},"totalCount":{"type":"integer"},"totalPages":{"type":"integer"}}},"PullResponse":{"type":"object","description":"Async task handle (`response.PullResponse`).","properties":{"taskId":{"type":"string"},"taskState":{"type":"string"}}}}},"paths":{"/dev/v1/remote/pull":{"post":{"operationId":"postDevV1RemotePull","tags":["DevV1"],"summary":"Get auditLog search result.","description":"Published summary from Swagger. **Response `data`** is **`PullResponse`** (`taskId`, `taskState`) for tracking an asynchronous operation.\n\nSend **`Nected-API-Key`** (via **DevAuth**) and optionally **`Nected-Branch`** (branch name).","parameters":[{"name":"Nected-Branch","in":"header","required":false,"description":"Branch name.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Response"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/PullResponse"}}}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## The Response object

```json
{"openapi":"3.0.3","info":{"title":"Nected Dev V1 — Remote pull","version":"1.0"},"components":{"schemas":{"Response":{"type":"object","description":"Standard API wrapper (`response.Response` in Swagger 2 definitions).","properties":{"code":{"type":"string"},"message":{"type":"string"},"data":{"type":"object","nullable":true},"pageNo":{"type":"integer"},"pageSize":{"type":"integer"},"totalCount":{"type":"integer"},"totalPages":{"type":"integer"}}}}}}
```

## The PullResponse object

```json
{"openapi":"3.0.3","info":{"title":"Nected Dev V1 — Remote pull","version":"1.0"},"components":{"schemas":{"PullResponse":{"type":"object","description":"Async task handle (`response.PullResponse`).","properties":{"taskId":{"type":"string"},"taskState":{"type":"string"}}}}}}
```