> ## 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.

# Set Intros Owner

> Set one owner on many warm intros at once

Set one owner on many warm intros in one call. This is each intro's own owner, the one
[Update Intro](https://docs.clustr-ai.com/api-reference/update-opportunity.md) sets on a single intro; notes and tags are left
alone. To move a connector's whole book, use [Set Connector Owner](https://docs.clustr-ai.com/api-reference/set-connector-owner.md).

Send `owner_id`, an owner from [List Owners](https://docs.clustr-ai.com/api-reference/list-owners.md), or `unassigned` to clear
it. Then exactly one of:

* `intros`: the intros, each as its `connector_linkedin_id` and `prospect_linkedin_id` (`per_`
  Clustr ids or LinkedIn slugs).
* `filters`: the warm intros list's filters, as a JSON object, for every intro they match.

More than 25,000 intros is a `400`. The answer says how many intros the selection `matched` and
how many were `updated` (their owner changed).

```bash cURL theme={null}
curl -X POST "https://api.clustr-ai.com/v2/intro_owners/set_owner" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "owner_id": "own_frqvq22ynqmxwrxe51m5e64cwq",
    "intros": [
      {"connector_linkedin_id": "per_bb771nzbxnmw9dhsnwhbt47j9b", "prospect_linkedin_id": "per_4bwcc6fsx7kz8aqg8hg6z0bf0p"}
    ]
  }'
```

```json 200 theme={null}
{
  "success": true,
  "data": { "matched": 1, "updated": 1 }
}
```


## OpenAPI

````yaml POST /v2/intro_owners/set_owner
openapi: 3.1.0
info:
  title: Clustr API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros, 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: '2.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com
    description: Production
security:
  - BearerAuth: []
paths:
  /v2/intro_owners/set_owner:
    post:
      tags:
        - Opportunities
      summary: Set Intros Owner
      description: >-
        Set one owner on many warm intros. Takes `owner_id` (an owner id from
        the workspace's directory, or `unassigned` to clear it) and exactly one
        of `intros` (each one's `connector_linkedin_id`, the connector, and
        `prospect_linkedin_id`, `per_` Clustr ids or LinkedIn slugs) or
        `filters` (the warm intros list's filters, for "select all N matching").
        Notes and tags are left alone. Over 25,000 intros is a 400. Returns
        `matched` (intros selected) and `updated` (intros whose owner changed).
      operationId: setOwnerIntroOwner
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - owner_id
              description: Exactly one of intros and filters.
              properties:
                owner_id:
                  type: string
                  description: >-
                    The owner: an `own_` Clustr id or uuid, or `unassigned` to
                    clear it.
                intros:
                  type: array
                  items:
                    type: object
                    description: One warm intro by its two people.
                    required:
                      - connector_linkedin_id
                      - prospect_linkedin_id
                    properties:
                      connector_linkedin_id:
                        type: string
                        description: >-
                          The connector: a `per_` Clustr id or the LinkedIn
                          slug.
                      prospect_linkedin_id:
                        type: string
                        description: 'The prospect: a `per_` Clustr id or the LinkedIn slug.'
                  description: The warm intros.
                filters:
                  allOf:
                    - $ref: '#/components/schemas/IntroSearchRequest'
                  description: The warm intros list's filters, for "select all N matching".
      responses:
        '200':
          description: Typed result envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SetPathsOwnerResultEnvelope'
              example:
                success: true
                data:
                  matched: 128
                  updated: 12
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    IntroSearchRequest:
      type: object
      description: >-
        The People (Warm intros) table's filters, sort and page. Every field is
        optional; an empty body lists every intro.
      properties:
        include:
          type: array
          description: >-
            Optional. Leave it out for the full row, as before. Name the heavy
            parts you want back, or `none` for the base row alone; the groups
            are those of `include` on GET /v2/intros. When `slim` is sent too,
            `include` wins.
          items:
            type: string
            enum:
              - none
              - engagements
              - shared_experiences
              - crm_activities
              - company_detail
              - owners
              - prospect_employment_at_company
        client_names:
          type: array
          items:
            type: string
          description: Connector names.
        connector_linkedin_urls:
          type: array
          items:
            type: string
        client_public_identifiers:
          type: array
          items:
            type: string
        customers:
          type: array
          items:
            type: string
          description: Customer company names of the connector.
        connector_role:
          type: string
        prospect_names:
          type: array
          items:
            type: string
        prospect_linkedin_urls:
          type: array
          items:
            type: string
        prospect_linkedin_ids:
          type: array
          items:
            type: string
        targetPeople:
          type: boolean
        targetPersonIds:
          type: array
          items:
            type: integer
        targetPersonLinkedInIds:
          type: array
          items:
            type: string
        prospect_positions:
          type: array
          items:
            type: string
        prospect_companies:
          type: array
          items:
            type: string
        buyer_title_ids:
          type: array
          items:
            type: string
          description: >-
            Buyer title ids the prospect matched; `__none__` asks for prospects
            matching none.
        prospect_job_functions:
          type: array
          items:
            type: string
          description: Job functions; `__none__` asks for prospects with none.
        prospect_seniority_ranks:
          type: array
          items:
            type: integer
          description: Seniority ranks (0..7); -1 asks for prospects with no level.
        target_seniority_levels:
          type: array
          items:
            type: string
        target_departments:
          type: array
          items:
            type: string
        target_industries:
          type: array
          items:
            type: string
        target_company_sizes:
          type: array
          items:
            type: string
        target_revenues:
          type: array
          items:
            type: string
        target_countries:
          type: array
          items:
            type: string
        target_cities:
          type: array
          items:
            type: string
        linked_in_urls:
          type: array
          items:
            type: string
        numeric_ids:
          type: array
          items:
            type: integer
        vanity_names:
          type: array
          items:
            type: string
        domains:
          type: array
          items:
            type: string
        confidence_ranges:
          type: array
          items:
            type: string
          description: Strength bands of the path.
        text_search:
          type: string
          description: Free text matched against the connector, prospect and company names.
        created_after:
          type: string
        created_before:
          type: string
        exclude_customers:
          type: boolean
          description: Hide prospects at your customers.
        exclude_customers_default:
          type: boolean
        job_changed:
          type: boolean
          description: Only prospects who recently changed employer.
        include_dismissed:
          type: boolean
          description: Also show dismissed intros.
        only_dismissed:
          type: boolean
          description: Show dismissed intros only.
        include_discarded_accounts:
          type: boolean
        exclude_discarded_accounts:
          type: boolean
        icp_fit:
          type: array
          items:
            type: string
          description: strong, partial or none, OR'd.
        fit:
          type: array
          items:
            type: string
          description: 'The account grade: A+, A, B, C or D, OR''d.'
        icp_id:
          type: array
          items:
            type: string
          description: 'One ICP by id: strong fits for that ICP.'
        competitor_ids:
          type: array
          items:
            type: string
        competitor_domains:
          type: array
          items:
            type: string
        competitorAnyDomains:
          type: array
          items:
            type: string
        intro_status:
          type: string
          description: Intro request states, comma-joined (requested,sent).
        slim:
          type: boolean
          description: Answer the rows without their decorations.
        skip_count:
          type: boolean
          description: Answer without the total count.
        job_id:
          type: string
        job_ids:
          type: array
          items:
            type: string
        owners:
          type: array
          items:
            type: string
          description: Intro owner ids, or `unassigned`.
        statuses:
          type: array
          items:
            type: string
        engagement_types:
          type: array
          items:
            type: string
        crm_statuses:
          type: array
          items:
            type: string
        connector_crm_statuses:
          type: array
          items:
            type: string
        prospect_crm_statuses:
          type: array
          items:
            type: string
          description: >-
            The prospect's CRM contact statuses, OR'd within the presence group
            (`IN_CRM`, `NOT_IN_CRM`, `ACTIVE_7D`, `ACTIVE_30D`, `ACTIVE_90D`,
            `NO_RECENT_ACTIVITY`, `HAS_OWNER`); `HAS_OWNER` keeps prospects
            matched to a CRM contact that has an owner. `HAS_EMAIL`, `HAS_CALL`,
            `HAS_MEETING`, `HAS_NOTE`, `HAS_TASK`, the activity directions and
            states narrow further.
        company_crm_statuses:
          type: array
          items:
            type: string
        crm_owner:
          type: string
          description: >-
            The prospect's CRM owner. `any` keeps prospects matched to a CRM
            contact that has an owner, `none` those with no owned CRM contact
            (not in the CRM, or no owner), and any other value is a CRM owner id
            (`crm.owner_id` on the prospect) and keeps that owner's prospects.
        connector_tag_ids:
          type: array
          items:
            type: string
          description: Tags on the connector.
        tag_ids:
          type: array
          items:
            type: string
          description: Tags on the intro.
        account_tag_ids:
          type: array
          items:
            type: string
          description: Tags on the prospect's account.
        tag_group_empty:
          type: array
          items:
            type: string
          description: >-
            Tag field ids: intros with no tag in that field, OR'd with that
            field's tag_ids.
        include_all_statuses:
          type: boolean
        include_stale_experiences:
          type: boolean
        include_unengaged:
          type: boolean
        include_connector_prospects:
          type: boolean
        evidence:
          type: string
          description: 'The view: recommended or all.'
        has_interaction:
          type: boolean
        only_target_accounts:
          type: boolean
          description: Only prospects at target accounts.
        tier_ids:
          type: array
          items:
            type: string
          description: Tier ids of the prospect's account.
        temperature:
          type: array
          items:
            type: string
        target_account:
          type: array
          items:
            type: string
        has_notes:
          type: array
          items:
            type: string
        added:
          type: array
          items:
            type: string
        dismiss_reasons:
          type: array
          items:
            type: string
        company_owners:
          type: array
          items:
            type: string
        assigned_owner:
          type: array
          items:
            type: string
        company_deal_stages:
          type: array
          items:
            type: string
        customer_of:
          type: array
          items:
            type: string
        customerOfCompanyIds:
          type: array
          items:
            type: string
        customerOfAnyCompanyIds:
          type: array
          items:
            type: string
        company_ids:
          type: array
          items:
            type: string
          description: Account ids the prospect works at.
        sort_field:
          type: string
          description: The column to sort by.
        sort_direction:
          type: string
          description: asc or desc.
        page:
          type: integer
          description: The page to answer, from 1.
        page_size:
          type: integer
          description: Rows per page.
        force_refresh:
          type: boolean
          description: Read past the cache.
        full_history:
          type: boolean
        owner:
          type: array
          items:
            type: string
          description: The same as owners; both are merged.
        cursor:
          type: object
          description: The next page's cursor, as the previous answer gave it.
          properties:
            lastScore:
              type: number
            lastId:
              type: string
            direction:
              type: string
              enum:
                - next
                - prev
    SetPathsOwnerResultEnvelope:
      example:
        success: true
        data:
          matched: 3
          updated: 3
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
        data:
          allOf:
            - $ref: '#/components/schemas/SetPathsOwnerResultData'
    SetPathsOwnerResultData:
      type: object
      required:
        - matched
        - updated
      properties:
        matched:
          type: integer
        updated:
          type: integer
    ErrorEnvelope:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          description: Always false.
        error:
          $ref: '#/components/schemas/ErrorInfo'
    ErrorInfo:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: >-
            What a client branches on, such as BAD_REQUEST or NOT_FOUND: one of
            the codes listed, the same on every operation. A code is added
            within a major version, never renamed.
          enum:
            - ADMIN_REQUIRED
            - ALREADY_LISTED
            - API_REQUEST_FAILED
            - ATTIO_NOT_CONNECTED
            - ATTIO_WORKSPACE_NOT_FOUND
            - AUTHORIZATION_UNAVAILABLE
            - AUTH_CONTEXT_ERROR
            - AUTH_FAILED
            - AUTH_METHOD_UNSUPPORTED
            - BAD_GATEWAY
            - BAD_REQUEST
            - BIGQUERY_ERROR
            - BODY_TOO_LARGE
            - BULK_PUSH_TOO_LARGE
            - BUYER_TITLES_UNAVAILABLE
            - CANCELLED
            - CANNOT_CHANGE_OWN_ROLE
            - CANNOT_DEACTIVATE_SELF
            - CANNOT_REMOVE_SELF
            - CLEANING_REPORT_FAILED
            - CLEANING_REPORT_UNAVAILABLE
            - CLIENT_CLOSED_REQUEST
            - COMPANY_NOT_FOUND
            - COMPANY_NOT_RESOLVED
            - COMPETITOR_EXISTS
            - COMPETITOR_READ_FAILED
            - COMPETITOR_RUN_FAILED
            - CONFLICT
            - CRM_CAPABILITY_UNSUPPORTED
            - CRM_CREDENTIAL_EXPIRED
            - CRM_DAILY_LIMIT
            - CRM_LISTS_UNSUPPORTED
            - CRM_NOT_ACTIVE
            - CRM_NOT_CONNECTED
            - CRM_RATE_LIMITED
            - CRM_RECONNECT_REQUIRED
            - CRM_ROW
            - CRM_SCHEMA_UNAVAILABLE
            - CRM_SCOPE_MISSING
            - CRM_UNAVAILABLE
            - CRM_VALUES_UNAVAILABLE
            - CRM_WRITE_DISABLED
            - CUSTOMERS_UNAVAILABLE
            - DATABASE_NOT_FOUND
            - DATASET_NOT_FOUND
            - DUPLICATE_ALREADY_RESOLVED
            - DUPLICATE_CHECK_FAILED
            - EMAIL_NOTIFIER_UNAVAILABLE
            - ENTITLEMENT_UNAVAILABLE
            - ESCALATION_EMAIL_DISABLED
            - EXPORT_FAILED
            - EXPORT_IN_FLIGHT
            - EXPORT_UNAVAILABLE
            - FAMILY_CLUSTER
            - FEATURE_NOT_ENABLED
            - FINDING_NOT_APPLICABLE
            - FIRE_FAILED
            - FORBIDDEN
            - FULLENRICH_API_ERROR
            - FULLENRICH_UNEXPECTED_ERROR
            - GATEWAY_TIMEOUT
            - HEADERS_TOO_LARGE
            - HUBSPOT_NOT_CONNECTED
            - HUBSPOT_UPSTREAM_ERROR
            - INSUFFICIENT_CREDITS
            - INSUFFICIENT_PERMISSION
            - INTEGRATION_REAUTH_REQUIRED
            - INTERNAL_ERROR
            - INVALID_BODY
            - INVALID_BOOLEAN
            - INVALID_BUCKET
            - INVALID_COMPANY_NAME
            - INVALID_CREDENTIALS
            - INVALID_CUSTOMER_RULE
            - INVALID_ENDPOINT
            - INVALID_EVENT
            - INVALID_FIELD
            - INVALID_INPUT
            - INVALID_LINKEDIN_URL
            - INVALID_MAPPING
            - INVALID_MATCHING_SETTINGS
            - INVALID_OBJECT_TYPE
            - INVALID_REQUEST
            - INVALID_SCHEDULE
            - INVALID_SETTINGS
            - INVALID_SIGNATURE
            - INVALID_TARGET_LIST
            - INVALID_TENANT_ID
            - INVALID_TOKEN
            - INVALID_URL
            - INVALID_UUID
            - INVALID_WEBSITE_URL
            - JOB_CLIENT_NOT_CONFIGURED
            - JOB_CREATION_FAILED
            - JOB_NOT_FOUND
            - KEY_NOT_REGISTERED
            - LAST_ADMIN
            - LOAD_FAILED
            - MAPPING_NOT_FOUND
            - MATCHING_SETTINGS_CONFLICT
            - MATCHING_VERSION_NOT_FOUND
            - MERGES_DISABLED
            - MERGE_UNRESOLVED
            - MERGE_UNSUPPORTED
            - METHOD_NOT_ALLOWED
            - MISSING_FIELDS
            - MISSING_HEADER
            - MISSING_JOB_ID
            - MISSING_OBJECT_ID
            - MISSING_PORTAL_ID
            - MISSING_TENANT_ID
            - MISSING_USER_ID
            - NOT_APPLIED
            - NOT_AUTO_SAFE
            - NOT_CONFIGURED
            - NOT_CONNECTED
            - NOT_DUPLICATE_CLUSTER
            - NOT_ENABLED
            - NOT_FOUND
            - NOT_RETRYABLE
            - NOT_REVERTABLE
            - NO_ACTIVE_WAREHOUSE
            - NO_BUYER_TITLES
            - NO_CONNECTION
            - NO_LINKEDIN_URL
            - NO_MATCH_KEY
            - NO_ORG
            - NO_PACKAGE
            - NO_SLOT
            - NO_TEAM_FOUND
            - NO_TOKEN
            - NO_WEBSITE
            - ORG_LIMIT_EXCEEDED
            - PANIC_RECOVERED
            - PARSE_ERROR
            - PAYLOAD_TOO_LARGE
            - PAYMENT_REQUIRED
            - PERSON_LEFT
            - PORTAL_TENANT_MISMATCH
            - PRIVATE_CHANNEL_NEEDS_INVITE
            - PROCESSING_ERROR
            - PROFILE_NOT_RESOLVED
            - PROJECT_NOT_FOUND
            - PROPERTY_INSIGHTS_FAILED
            - PROPERTY_INSIGHTS_UNAVAILABLE
            - QUEUE_UNAVAILABLE
            - RATE_LIMITED
            - RATE_LIMITER_INIT_FAILED
            - RATE_LIMIT_EXCEEDED
            - REDIRECT_REFUSED
            - REFRESH_RATE_LIMITED
            - REFRESH_UNAVAILABLE
            - REPORT_ONLY_DUPLICATE
            - REQUEST_FAILED
            - RESEARCH_NOT_STARTED
            - RESOURCE_EXHAUSTED
            - RESPONSE_READ_FAILED
            - REVERT_BATCH_UNAVAILABLE
            - REVERT_CONFLICT
            - REVERT_EXPIRED
            - ROUTE_NOT_FOUND
            - SALESFORCE_NOT_CONNECTED
            - SALESFORCE_ORG_NOT_FOUND
            - SAVE_FAILED
            - SEARCH_FAILED
            - SERVICE_NOT_FOUND
            - SERVICE_UNAVAILABLE
            - SERVICE_UNREACHABLE
            - SETUP_FAILED
            - SETUP_RATE_LIMITED
            - SLACK_REJECTED
            - SNOWFLAKE_ERROR
            - STAFF_REQUIRED
            - SUPABASE_NEEDS_POOLER
            - SYNC_IN_PROGRESS
            - SYNC_PROPERTIES_DISABLED
            - SYNC_STATUS_UNAVAILABLE
            - SYNC_UNAVAILABLE
            - TABLE_SHAPE_MISMATCH
            - TARGET_ACCOUNTS_UNAVAILABLE
            - TARGET_LIST_NOT_BINDABLE
            - TARGET_LIST_NOT_FOUND
            - TASK_CREATION_FAILED
            - TENANT_LOOKUP_FAILED
            - TENANT_MISMATCH
            - TOO_MANY_HEADERS
            - TOO_SOON
            - UNAUTHORIZED
            - UNAVAILABLE
            - UNKNOWN_ERROR
            - UNKNOWN_FEATURE
            - UNKNOWN_PORTAL
            - UNKNOWN_PROVIDER
            - UNPROCESSABLE_ENTITY
            - UNSUPPORTED_FLOW
            - UNSUPPORTED_MEDIA_TYPE
            - UNSUPPORTED_OBJECT_TYPE
            - UNSUPPORTED_PROVIDER
            - UNSUPPORTED_RESOURCE_TYPE
            - UPSTREAM_ERROR
            - UPSTREAM_UNAVAILABLE
            - URL_TOO_LONG
            - USER_NOT_AUTHORIZED
            - VALIDATION_ERROR
            - VALUES_FAILED
            - VALUES_UNAVAILABLE
            - VERIFICATION_UNAVAILABLE
            - WEBHOOK_UNAVAILABLE
        message:
          type: string
          description: The sentence a person reads.
        details:
          type: string
          description: Developer text, returned outside production only.
        request_id:
          type: string
          description: >-
            The request's id, for support. Always set, and the same as the
            X-Request-ID response header.
  responses:
    BadRequest:
      description: Request validation failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Unauthorized:
      description: Missing or invalid auth.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Forbidden:
      description: Authenticated caller is not permitted for this resource.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    NotFound:
      description: Resource does not exist.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    InternalServerError:
      description: Unexpected server-side failure.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  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.