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

# Update media eligibility scores

> Apply eligibility scores to up to 500 tracked campaign posts in one request.

## POST /sdk/v1/campaign-media/eligibility-scores/bulk

Applies eligibility scores to up to 500 tracked posts. Grade verifies every
`campaignCreatorMediaId` belongs to your agency before saving it.

All requests require `X-Application-Id` and `X-Api-Key`.

### Body

`scores` is a non-empty array with no more than 500 items. Each item requires:

* `campaignCreatorMediaId`: the ID returned by campaign media or the eligibility
  score list.
* `score`: a number from `0` through `100`. Values are stored to two decimal
  places.

Each media ID can appear only once in a request.

### Example request

```bash theme={null}
curl -sS "$BASE_URL/sdk/v1/campaign-media/eligibility-scores/bulk" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Application-Id: $APP_ID" \
  -H "X-Api-Key: $API_KEY" \
  -d '{
    "scores": [
      { "campaignCreatorMediaId": "CCMEDIA_123", "score": 82.5 },
      { "campaignCreatorMediaId": "CCMEDIA_456", "score": 67 }
    ]
  }'
```

### Response

The response follows the input order and reports each item separately. Media
that was not found or does not belong to your agency is skipped.

```json theme={null}
{
  "success": true,
  "appliedCount": 1,
  "failedCount": 1,
  "results": [
    {
      "campaignCreatorMediaId": "CCMEDIA_123",
      "status": "APPLIED",
      "score": 82.5
    },
    {
      "campaignCreatorMediaId": "CCMEDIA_456",
      "status": "FAILED",
      "reason": "Campaign creator media was not found."
    }
  ]
}
```

After scores are applied, Grade refreshes the affected creators' calculated
payment summaries.

### Common errors

* `400`: empty batch, invalid score, duplicate media ID, or more than 500 items
* `401`: missing or invalid SDK credentials