Establecer las organizaciones de facturación de los usuarios
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"
}Usuarios y membresía (Enterprise)
Establecer las organizaciones de facturación de los usuarios
Establecer la organización de facturación de hasta 100 usuarios.
Solo se modifican los usuarios incluidos en la solicitud. Las asignaciones válidas se guardan juntas aunque
otras no sean válidas, por lo que una respuesta 200 puede incluir fallos: compruebe siempre failed.
Una respuesta de error significa que no se ha guardado nada. Reenviar una asignación sobrescribe
la organización de facturación actual del usuario y añade otra entrada al registro de auditoría.
PUT
/
v3
/
enterprise
/
members
/
users
/
billing-orgs
Establecer las organizaciones de facturación de los usuarios
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"
}Establece la organización de facturación de hasta 100 usuarios en una sola solicitud. Solo se modifican los usuarios que envíes; el resto de la empresa no se ve afectado. Para actualizar los usuarios de uno en uno, el endpoint de configuración de usuario, en beta, también acepta
Es posible que se agreguen nuevos motivos con el tiempo, así que trata los valores desconocidos como un fallo y no como un error.
Una respuesta de error (
billing_org_id.
Éxito parcial
Las asignaciones válidas se guardan en conjunto aunque otras filas de la misma solicitud no sean válidas, por lo que una respuesta200 puede incluir fallos. Revisa siempre failed: cada entrada indica el usuario, la organización solicitada y un reason. La organización de facturación de esos usuarios no cambió; corrige las filas y vuelve a enviarlas.
reason | Significado |
|---|---|
user_not_found | El usuario no es miembro de la empresa, ni directamente ni a través de un grupo del proveedor de identidad. |
org_not_found | La organización no pertenece a la empresa. |
user_not_org_member | La organización no es la organización principal de la empresa y el usuario no es miembro de ella. |
4xx o 5xx) significa que no se guardó nada de la solicitud. Las solicitudes sin asignaciones, con más de 100 asignaciones o con el mismo user_id repetido se rechazan con 422.
Volver a enviar una asignación sobrescribe la organización de facturación actual del usuario y agrega otra entrada al registro de auditoría, por lo que repetir las llamadas es seguro, pero no gratuito.
Permisos
Requiere un usuario de servicio o un token de acceso personal con los permisosManageBilling y ViewOrganizations a nivel empresarial. ManageOrganizations también cumple el requisito de ViewOrganizations, ya que lo incluye.Cuerpo
application/json
Respuesta
Respuesta satisfactoria

