Imposta le organizzazioni di fatturazione degli utenti
curl --request PUT \
--url https://api.devin.ai/v3/enterprise/members/users/billing-orgs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"assignments": [
{
"billing_org_id": "<string>",
"user_id": "<string>"
}
]
}
'import requests
url = "https://api.devin.ai/v3/enterprise/members/users/billing-orgs"
payload = { "assignments": [
{
"billing_org_id": "<string>",
"user_id": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({assignments: [{billing_org_id: '<string>', user_id: '<string>'}]})
};
fetch('https://api.devin.ai/v3/enterprise/members/users/billing-orgs', 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.devin.ai/v3/enterprise/members/users/billing-orgs",
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([
'assignments' => [
[
'billing_org_id' => '<string>',
'user_id' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.devin.ai/v3/enterprise/members/users/billing-orgs"
payload := strings.NewReader("{\n \"assignments\": [\n {\n \"billing_org_id\": \"<string>\",\n \"user_id\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.devin.ai/v3/enterprise/members/users/billing-orgs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"assignments\": [\n {\n \"billing_org_id\": \"<string>\",\n \"user_id\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.devin.ai/v3/enterprise/members/users/billing-orgs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"assignments\": [\n {\n \"billing_org_id\": \"<string>\",\n \"user_id\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"assigned": [
{
"billing_org_id": "<string>",
"user_id": "<string>"
}
],
"failed": [
{
"billing_org_id": "<string>",
"reason": "user_not_found",
"user_id": "<string>"
}
]
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}Utenti e appartenenza (Enterprise)
Imposta le organizzazioni di fatturazione degli utenti
Imposta l’organizzazione di fatturazione per un massimo di 100 utenti.
Vengono modificati solo gli utenti indicati nella richiesta. Le assegnazioni valide vengono salvate insieme anche
se altre non sono valide, quindi una risposta 200 può includere errori: verifica sempre failed.
Una risposta di errore indica che non è stato salvato nulla. Il reinvio di un’assegnazione sovrascrive
l’organizzazione di fatturazione attuale dell’utente e aggiunge una nuova voce al registro di audit.
PUT
/
v3
/
enterprise
/
members
/
users
/
billing-orgs
Imposta le organizzazioni di fatturazione degli utenti
curl --request PUT \
--url https://api.devin.ai/v3/enterprise/members/users/billing-orgs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"assignments": [
{
"billing_org_id": "<string>",
"user_id": "<string>"
}
]
}
'import requests
url = "https://api.devin.ai/v3/enterprise/members/users/billing-orgs"
payload = { "assignments": [
{
"billing_org_id": "<string>",
"user_id": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({assignments: [{billing_org_id: '<string>', user_id: '<string>'}]})
};
fetch('https://api.devin.ai/v3/enterprise/members/users/billing-orgs', 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.devin.ai/v3/enterprise/members/users/billing-orgs",
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([
'assignments' => [
[
'billing_org_id' => '<string>',
'user_id' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.devin.ai/v3/enterprise/members/users/billing-orgs"
payload := strings.NewReader("{\n \"assignments\": [\n {\n \"billing_org_id\": \"<string>\",\n \"user_id\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.devin.ai/v3/enterprise/members/users/billing-orgs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"assignments\": [\n {\n \"billing_org_id\": \"<string>\",\n \"user_id\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.devin.ai/v3/enterprise/members/users/billing-orgs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"assignments\": [\n {\n \"billing_org_id\": \"<string>\",\n \"user_id\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"assigned": [
{
"billing_org_id": "<string>",
"user_id": "<string>"
}
],
"failed": [
{
"billing_org_id": "<string>",
"reason": "user_not_found",
"user_id": "<string>"
}
]
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}{
"status": 123,
"title": "<string>",
"detail": "<string>",
"error_code": "<string>",
"errors": [
{}
],
"instance": "<string>",
"type": "about:blank"
}Imposta l’organizzazione di fatturazione per un massimo di 100 utenti con un’unica richiesta. Vengono modificati solo gli utenti inviati, mentre il resto dell’azienda rimane invariato. Per aggiornare un solo utente alla volta, puoi usare anche l’endpoint delle impostazioni utente, in beta, che accetta
In futuro potrebbero essere aggiunti nuovi motivi: tratta quindi i valori sconosciuti come un’assegnazione non riuscita e non come un errore della richiesta.
Una risposta di errore (
billing_org_id.
Esito parziale
Le assegnazioni valide vengono salvate comunque, anche se altre righe della stessa richiesta non sono valide: una risposta200 può quindi contenere errori. Controlla sempre failed: ogni voce indica l’utente, l’organizzazione richiesta e un reason. Per questi utenti l’organizzazione di fatturazione non è stata modificata; correggi le righe e inviale di nuovo.
reason | Significato |
|---|---|
user_not_found | L’utente non è membro dell’azienda, né direttamente né tramite un gruppo del provider di identità. |
org_not_found | L’organizzazione non appartiene all’azienda. |
user_not_org_member | L’organizzazione non è l’organizzazione principale dell’azienda e l’utente non ne è membro. |
4xx o 5xx) indica che nessun elemento della richiesta è stato salvato. Le richieste senza assegnazioni, con più di 100 assegnazioni o con lo stesso user_id ripetuto più volte vengono rifiutate con 422.
Inviare di nuovo un’assegnazione sovrascrive l’organizzazione di fatturazione attuale dell’utente e aggiunge un’ulteriore voce al registro di audit: le chiamate ripetute sono quindi sicure, ma non prive di effetti.
Autorizzazioni
Richiede un utente di servizio o un token di accesso personale con entrambe le autorizzazioniManageBilling e ViewOrganizations a livello aziendale. Anche ManageOrganizations soddisfa il requisito di ViewOrganizations, poiché lo include.Autorizzazioni
Corpo
application/json
Risposta
Risposta riuscita

