Add Digital Humans To Community

curl --request PUT \
  --url https://api.getbluejay.ai/v1/add-to-community/{community_id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "digital_human_ids": [
    123
  ]
}
'

import requests

url = "https://api.getbluejay.ai/v1/add-to-community/{community_id}"

payload = { "digital_human_ids": [123] }
headers = {
    "X-API-Key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'X-API-Key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({digital_human_ids: [123]})
};

fetch('https://api.getbluejay.ai/v1/add-to-community/{community_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getbluejay.ai/v1/add-to-community/{community_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'digital_human_ids' => [
        123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getbluejay.ai/v1/add-to-community/{community_id}"

	payload := strings.NewReader("{\n  \"digital_human_ids\": [\n    123\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-API-Key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.getbluejay.ai/v1/add-to-community/{community_id}")
  .header("X-API-Key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"digital_human_ids\": [\n    123\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getbluejay.ai/v1/add-to-community/{community_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"digital_human_ids\": [\n    123\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "title": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "digital_human_ids": [
    123
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

PUT

add-to-community

{community_id}

Add Digital Humans To Community

curl --request PUT \
  --url https://api.getbluejay.ai/v1/add-to-community/{community_id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "digital_human_ids": [
    123
  ]
}
'

import requests

url = "https://api.getbluejay.ai/v1/add-to-community/{community_id}"

payload = { "digital_human_ids": [123] }
headers = {
    "X-API-Key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'X-API-Key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({digital_human_ids: [123]})
};

fetch('https://api.getbluejay.ai/v1/add-to-community/{community_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getbluejay.ai/v1/add-to-community/{community_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'digital_human_ids' => [
        123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getbluejay.ai/v1/add-to-community/{community_id}"

	payload := strings.NewReader("{\n  \"digital_human_ids\": [\n    123\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-API-Key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.getbluejay.ai/v1/add-to-community/{community_id}")
  .header("X-API-Key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"digital_human_ids\": [\n    123\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getbluejay.ai/v1/add-to-community/{community_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"digital_human_ids\": [\n    123\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "title": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "digital_human_ids": [
    123
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Integration Prompt for AI Agents

# Bluejay — Testing & Monitoring Platform for Conversational AI Agents

You are a senior backend engineer integrating the Bluejay API. Think step-by-step: first understand the endpoint, then plan the integration, then implement with minimal changes.

## Add Digital Humans To Community — PUT /v1/add-to-community/{community_id}

> **What this endpoint does:** Add Digital Humans to an existing community without replacing the current list.

**Endpoint:** PUT `https://api.getbluejay.ai/v1/add-to-community/{community_id}`
**Auth:** `X-API-Key` header
**Content-Type:** application/json

### Required Parameters
| Name | Type | Description |
|------|------|-------------|
| community_id | string |  |
| X-API-Key | string | API key required to authenticate requests. |
| digital_human_ids | array[integer] | List of Digital Human (test case) IDs to add to this community |

### Request Body (required fields)
```json
{
  "digital_human_ids": [
    123
  ]
}
```

Refer to the full schema at https://docs.getbluejay.ai/api-reference/endpoint/add-to-community. Include optional fields that serve the goal of setting up for testing and monitoring on Bluejay.

### Example
**PUT with body:**
```python
import requests

def add_digital_humans_to_community(community_id: str, payload: dict, api_key: str) -> dict:
    url = f"https://api.getbluejay.ai/v1/add-to-community/{community_id}"
    headers = {"X-API-Key": api_key}
    response = requests.put(url, headers=headers, json=payload)
    response.raise_for_status()
    return response.json()
```

### Constraints
- Minimal changes — only add/change files needed for this integration.
- Match existing codebase patterns (naming, file structure, error handling).
- Include error handling for 422: Validation Error.

### Integration Checklist
Before writing code, verify:
1. Which module/service owns this API domain in the codebase?
2. What HTTP client and error-handling patterns does the project use?
3. Are there existing types/interfaces to extend?

Then implement the integration, export it, and confirm it compiles/passes lint.

This endpoint allows you to add Digital Humans to an existing community without replacing the current list. Provide the community ID in the path and the list of Digital Human IDs in the request body.

Headers

X-Organization-Id

string

X-API-Key

string

required

API key required to authenticate requests.

Path Parameters

community_id

string<uuid>

required

Body

application/json

digital_human_ids

integer[]

required

List of digital human (test case) IDs to add to this community

Response

Successful Response

Response model for community operations

string

required

Unique identifier for the community

title

string

required

Title of the community

created_at

string<date-time>

required

When this community was created

description

string | null

Description of the community

digital_human_ids

integer[]

List of digital human (test case) IDs associated with this community

Overview

Endpoints

Add Digital Humans To Community

Headers

Path Parameters

Body

Response