> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Competitor Team Refresh

> Refresh a competitor's team now instead of waiting for the monthly refresh

Runs the competitor's [team refresh](https://docs.clustr-ai.com/api-reference/list-competitor-team-refreshes.md) now: the
Sales and CS search runs again, joiners are followed automatically while you have free slots
(past your limit they are added Paused, not followed), and every monitored and paused
person is checked on LinkedIn to mark leavers and role changes. Clustr skips people it checked in
the last week, so refreshing twice in a row costs once. Activity is collected by the next
scheduled collection.

The call answers `202` as soon as the refresh has started. Its result appears in
[List Competitor Team Refreshes](https://docs.clustr-ai.com/api-reference/list-competitor-team-refreshes.md), usually within
a few minutes. A second call within the same hour joins the refresh already started
(`started: false`, `attached: true`) instead of starting another one. The request has no body.

```bash cURL theme={null}
curl -X POST https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/team-refresh \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```python Python theme={null}
import requests

requests.post(
    "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/team-refresh",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
```

```javascript JavaScript theme={null}
await fetch("https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/team-refresh", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
```

```json 202 theme={null}
{
  "success": true,
  "data": {
    "started": true,
    "attached": false,
    "workflow_id": "competitor-team-refresh-c1a2b3c4-d5e6-7890-abcd-ef1234567890-2026110809"
  }
}
```


## OpenAPI

````yaml POST /competitors/{id}/team-refresh
openapi: 3.1.0
info:
  title: Clustr Public API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros (opportunities), and manage target accounts.


    ## Authentication

    All endpoints require a Bearer token (API key) in the `Authorization`
    header.


    ```

    Authorization: Bearer <your_api_key>

    ```


    API keys can be created and managed from the [API settings
    page](https://app.clustr-ai.com/api).
  version: '1.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com/api/public
    description: Production
security:
  - BearerAuth: []
paths:
  /competitors/{id}/team-refresh:
    post:
      tags:
        - Competitor Monitoring
      summary: Run Competitor Team Refresh
      description: >
        Refresh the competitor's team now instead of waiting for the monthly
        refresh. The

        answer comes back as soon as the refresh has started; its result shows
        in

        [List Competitor Team
        Refreshes](/api-reference/list-competitor-team-refreshes) a few

        minutes later. A second request within the same hour joins the refresh
        already started.
      operationId: runCompetitorTeamRefresh
      parameters:
        - name: id
          in: path
          required: true
          description: >-
            The competitor's Clustr ID (`cmp_…`), from [List
            Competitors](/api-reference/list-competitors).

            The id from earlier responses also works.
          schema:
            type: string
          example: cmp_b2s2b7ajadacnf4reafa8bqbme
      responses:
        '202':
          description: The refresh started, or was already started this hour
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - data
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      started:
                        type: boolean
                        example: true
                      attached:
                        type: boolean
                        example: false
                      workflow_id:
                        type: string
        '401':
          description: Invalid or missing API key
        '404':
          description: Competitor not found
        '503':
          description: Refreshes cannot be started right now. Try again in a few minutes.
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: The API key you created on the API settings page of the Clustr app.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.