cURL
curl --request POST \
--url https://recoup-api.vercel.app/api/chats \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"artistId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chatId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://recoup-api.vercel.app/api/chats"
payload = {
"artistId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chatId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
artistId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
chatId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
accountId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://recoup-api.vercel.app/api/chats', 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://recoup-api.vercel.app/api/chats",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'artistId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'chatId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'accountId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <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://recoup-api.vercel.app/api/chats"
payload := strings.NewReader("{\n \"artistId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"chatId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"accountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<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.post("https://recoup-api.vercel.app/api/chats")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"artistId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"chatId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"accountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://recoup-api.vercel.app/api/chats")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"artistId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"chatId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"accountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"chat": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"topic": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"artist_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}Chat
Create
Create a new chat room. Optionally associate it with an artist and/or provide a client-generated chat ID. Organization API keys can create chats on behalf of other accounts within their organization by specifying an accountId.
POST
/
api
/
chats
cURL
curl --request POST \
--url https://recoup-api.vercel.app/api/chats \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"artistId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chatId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://recoup-api.vercel.app/api/chats"
payload = {
"artistId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chatId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
artistId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
chatId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
accountId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://recoup-api.vercel.app/api/chats', 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://recoup-api.vercel.app/api/chats",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'artistId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'chatId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'accountId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <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://recoup-api.vercel.app/api/chats"
payload := strings.NewReader("{\n \"artistId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"chatId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"accountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<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.post("https://recoup-api.vercel.app/api/chats")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"artistId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"chatId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"accountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://recoup-api.vercel.app/api/chats")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"artistId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"chatId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"accountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"chat": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"topic": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"artist_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}Authorizations
Your Recoup API key. Learn more.
Body
application/json
Chat creation parameters
UUID of the artist account the chat is associated with
UUID for the new chat (client-generated). If not provided, one will be generated automatically.
UUID of the account to create the chat for. Only applicable for organization API keys - org keys can specify an accountId for any account within their organization. The Recoup admin organization can specify any accountId. If not provided, the chat is created for the API key's own account.
⌘I