# Search AWS connected partners by name

`POST https://api.suger.cloud/org/{orgId}/cosell/partner/AWS/searchPartner`

Search the org's connected AWS partners by name. Returns matching partner connections — each item has `id`, `name`, and `awsAccountId` — usable as `partnerId` when creating an outbound AWS co-sell referral.

AWS-only. For Azure / GCP, partner selection happens through different mechanisms.

Use this when: user is drafting an AWS co-sell referral and needs to pick which connected partner to share with.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `query` | query | string | yes | Search query (partner name) |
| `limit` | query | integer | no | Maximum results (default 20, max 100) |

## Responses

### 200 — OK

Content-Type: `application/json`

**`PartnerConnectionSearchResult`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `awsAccountId` | string | no | AwsAccountId is the AWS account ID of the partner. |
| `id` | string | no | ID is the unique identifier for the partner connection. |
| `name` | string | no | Name is the display name of the partner. |

### 400 — Bad Request

Content-Type: `application/json` · Schema: `ErrorResponse`

**`ErrorResponse`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | ErrorCode | no |  |
| `info` | object | no |  |
| `message` | string | no |  |

### 500 — Internal Server Error

Content-Type: `application/json` · Schema: `ErrorResponse`

**`ErrorResponse`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | ErrorCode | no |  |
| `info` | object | no |  |
| `message` | string | no |  |

## Example

_Generated from this operation's schema. Values are placeholders — substitute your own ids, and set `SUGER_TOKEN` to a bearer token from the [OAuth client-credentials exchange](https://doc.fours.com/settings/oauth-app/)._

### Request

```bash
curl -X POST 'https://api.suger.cloud/org/{orgId}/cosell/partner/AWS/searchPartner?query={query}' \
  -H "Authorization: Bearer $SUGER_TOKEN"
```

### Response — 200

```json
[
  {
    "awsAccountId": "01H0000000000000000000",
    "id": "01H0000000000000000000",
    "name": "Acme Corp"
  }
]
```

### Error — 400

```json
{
  "code": "InternalServerError",
  "message": "string"
}
```

---

API reference: https://doc.fours.com/api/