---
title: "Manually trigger one Associate AI Agent Gmail poll cycle."
method: POST
path: "/api/associate/poll"
tags: ["associate"]
---

# Manually trigger one Associate AI Agent Gmail poll cycle.

`POST /api/associate/poll`

## Request

- Base URL: `https://localhost:8080`
- URL: `https://localhost:8080/api/associate/poll`
- Auth: none declared. Required headers: `x-associate-secret`

## Headers

- `x-associate-secret` string, required

## Response `200`

Poll completed; returns per-outcome counts.

## Other responses

- `403`: Forbidden: missing/wrong secret.
- `503`: Misconfigured: ASSOCIATE_POLL_SECRET is unset.

---

[API](https://skmtc.dev/opencase/apis/opencase-backend-api.md) · [All operations](https://skmtc.dev/opencase/apis/opencase-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/opencase/apis/opencase-backend-api/revisions/c66ef2d8dc00?raw)