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

# Update Finder Shortlist Item

> Update contact details, notes, or workflow status on a saved opportunity

## Path Parameters

<ParamField path="id" type="string" required>
  Shortlist item ID
</ParamField>

## Body Parameters

At least one field must be provided.

<ParamField body="emails" type="string[]">
  Replacement list of contact emails. Maximum 100 items. Each value must be a valid email.
</ParamField>

<ParamField body="social_media" type="string[]">
  Replacement list of social profile URLs. Maximum 100 items. Each value must be a valid URL.
</ParamField>

<ParamField body="notes" type="string | null">
  Notes. Maximum 5000 characters. Set to `null` to clear.
</ParamField>

<ParamField body="status" type="string | null">
  Workflow status. Maximum 50 characters. Set to `null` to clear.
</ParamField>

## Response

The response includes the updated shortlist item.

<ResponseField name="success" type="boolean">
  Always `true` for successful responses
</ResponseField>

<ResponseField name="data" type="object">
  The updated shortlist item.

  <Expandable title="Data Object Properties">
    <ResponseField name="id" type="string">
      Unique identifier for the shortlist item
    </ResponseField>

    <ResponseField name="name" type="string">
      Opportunity name
    </ResponseField>

    <ResponseField name="domain" type="string">
      Opportunity domain
    </ResponseField>

    <ResponseField name="urls" type="string[]">
      URLs grouped into this shortlist item
    </ResponseField>

    <ResponseField name="category" type="string">
      Opportunity category
    </ResponseField>

    <ResponseField name="emails" type="string[]">
      Saved contact emails
    </ResponseField>

    <ResponseField name="social_media" type="string[]">
      Saved social profile URLs
    </ResponseField>

    <ResponseField name="notes" type="string | null">
      Notes, or `null` if unset
    </ResponseField>

    <ResponseField name="status" type="string | null">
      Workflow status, or `null` if unset
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the item was created
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of when the item was last updated
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH "https://api.affonso.io/v1/finder/shortlist/cmk2q1wau0003sb01lpvka003" \
    -H "Authorization: Bearer sk_live_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "emails": ["hello@example.com"],
      "social_media": ["https://x.com/example"],
      "notes": "Reached out on Monday",
      "status": "CONTACTED"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "id": "cmk2q1wau0003sb01lpvka003",
      "name": "Example",
      "domain": "example.com",
      "urls": [
        "https://example.com/article"
      ],
      "category": "google",
      "emails": [
        "hello@example.com"
      ],
      "social_media": [
        "https://x.com/example"
      ],
      "notes": "Reached out on Monday",
      "status": "CONTACTED",
      "created_at": "2026-08-28T00:00:00.000Z",
      "updated_at": "2026-08-28T02:00:00.000Z"
    }
  }
  ```
</ResponseExample>

## Errors

| Status | Code               | Description                                 |
| ------ | ------------------ | ------------------------------------------- |
| `400`  | `VALIDATION_ERROR` | Invalid request body, or no fields provided |
| `404`  | `NOT_FOUND`        | Finder shortlist item not found             |

## Notes

* Requires the `write:finder` permission.