PUT
/api/v1_2/agendas/:agenda_idUpdates information about this Folder (agenda). Folder properties can be updated by Folder (agenda) owner only. Updated are only attributes filled in request body.
Path parameters
| Name | Example | Description |
|---|---|---|
agenda_id |
— | — |
Headers
| Name | Example | Description |
|---|---|---|
Content-Type |
application/json | — |
Request body
{
"agendas": [
{
"name": "Demo Trading Ltd",
"address": {
"street": "Zochova",
"building_no": "6 - 8",
"city": "Bratislava",
"postal_code": "811 03",
"country": "sk"
},
"company_id": "12345678",
"company_tax_id": "1002003000",
"company_vat_id": null,
"home_currency": "EUR",
"email_alias": "demo-invoices",
"email_whitelist": "invoices@example.com, finance@example.com",
"external_id": "EXT-2026-0001",
"client_id": "demo_client_id"
}
]
}Code examples
curl --request PUT 'https://app.datamolino.com/api/v1_2/agendas/12345' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer demo_access_token' \
--data '{
"agendas": [
{
"name": "Demo Trading Ltd",
"address": {
"street": "Zochova",
"building_no": "6 - 8",
"city": "Bratislava",
"postal_code": "811 03",
"country": "sk"
},
"company_id": "12345678",
"company_tax_id": "1002003000",
"company_vat_id": null,
"home_currency": "EUR",
"email_alias": "demo-invoices",
"email_whitelist": "invoices@example.com, finance@example.com",
"external_id": "EXT-2026-0001",
"client_id": "demo_client_id"
}
]
}'PUT /api/v1_2/agendas/12345 HTTP/1.1
Host: app.datamolino.com
Content-Type: application/json
Authorization: Bearer demo_access_token
{
"agendas": [
{
"name": "Demo Trading Ltd",
"address": {
"street": "Zochova",
"building_no": "6 - 8",
"city": "Bratislava",
"postal_code": "811 03",
"country": "sk"
},
"company_id": "12345678",
"company_tax_id": "1002003000",
"company_vat_id": null,
"home_currency": "EUR",
"email_alias": "demo-invoices",
"email_whitelist": "invoices@example.com, finance@example.com",
"external_id": "EXT-2026-0001",
"client_id": "demo_client_id"
}
]
}const response = await fetch("https://app.datamolino.com/api/v1_2/agendas/12345", {
method: "PUT",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer demo_access_token"
},
body: JSON.stringify({
"agendas": [
{
"name": "Demo Trading Ltd",
"address": {
"street": "Zochova",
"building_no": "6 - 8",
"city": "Bratislava",
"postal_code": "811 03",
"country": "sk"
},
"company_id": "12345678",
"company_tax_id": "1002003000",
"company_vat_id": null,
"home_currency": "EUR",
"email_alias": "demo-invoices",
"email_whitelist": "invoices@example.com, finance@example.com",
"external_id": "EXT-2026-0001",
"client_id": "demo_client_id"
}
]
}),
});
const data = await response.json();import axios from "axios";
const response = await axios({
method: "put",
url: "https://app.datamolino.com/api/v1_2/agendas/12345",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer demo_access_token"
},
data: {
"agendas": [
{
"name": "Demo Trading Ltd",
"address": {
"street": "Zochova",
"building_no": "6 - 8",
"city": "Bratislava",
"postal_code": "811 03",
"country": "sk"
},
"company_id": "12345678",
"company_tax_id": "1002003000",
"company_vat_id": null,
"home_currency": "EUR",
"email_alias": "demo-invoices",
"email_whitelist": "invoices@example.com, finance@example.com",
"external_id": "EXT-2026-0001",
"client_id": "demo_client_id"
}
]
}
});
console.log(response.data);import requests
url = "https://app.datamolino.com/api/v1_2/agendas/12345"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer demo_access_token"
}
payload = {
"agendas": [
{
"name": "Demo Trading Ltd",
"address": {
"street": "Zochova",
"building_no": "6 - 8",
"city": "Bratislava",
"postal_code": "811 03",
"country": "sk"
},
"company_id": "12345678",
"company_tax_id": "1002003000",
"company_vat_id": None,
"home_currency": "EUR",
"email_alias": "demo-invoices",
"email_whitelist": "invoices@example.com, finance@example.com",
"external_id": "EXT-2026-0001",
"client_id": "demo_client_id"
}
]
}
response = requests.request("PUT", url, headers=headers, json=payload)
response.raise_for_status()
print(response.json())require 'json'
require 'net/http'
uri = URI("https://app.datamolino.com/api/v1_2/agendas/12345")
request = Net::HTTP::Put.new(uri)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer demo_access_token"
request.body = <<~JSON
{
"agendas": [
{
"name": "Demo Trading Ltd",
"address": {
"street": "Zochova",
"building_no": "6 - 8",
"city": "Bratislava",
"postal_code": "811 03",
"country": "sk"
},
"company_id": "12345678",
"company_tax_id": "1002003000",
"company_vat_id": null,
"home_currency": "EUR",
"email_alias": "demo-invoices",
"email_whitelist": "invoices@example.com, finance@example.com",
"external_id": "EXT-2026-0001",
"client_id": "demo_client_id"
}
]
}
JSON
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
http.request(request)
end
puts JSON.parse(response.body)# app/services/datamolino_client.rb
require 'json'
require 'net/http'
class DatamolinoClient
BASE_URL = "https://app.datamolino.com"
def initialize(access_token: Rails.application.credentials.dig(:datamolino, :access_token))
@access_token = access_token
end
def request_update_agenda
uri = URI("#{BASE_URL}/api/v1_2/agendas/12345")
request = Net::HTTP::Put.new(uri)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer #{@access_token}"
request.body = <<~JSON
{
"agendas": [
{
"name": "Demo Trading Ltd",
"address": {
"street": "Zochova",
"building_no": "6 - 8",
"city": "Bratislava",
"postal_code": "811 03",
"country": "sk"
},
"company_id": "12345678",
"company_tax_id": "1002003000",
"company_vat_id": null,
"home_currency": "EUR",
"email_alias": "demo-invoices",
"email_whitelist": "invoices@example.com, finance@example.com",
"external_id": "EXT-2026-0001",
"client_id": "demo_client_id"
}
]
}
JSON
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
JSON.parse(response.body)
end
end<?php
use GuzzleHttp\Client;
$client = new Client();
$response = $client->request('PUT', 'https://app.datamolino.com/api/v1_2/agendas/12345', [
'headers' => json_decode('{"Content-Type":"application/json","Authorization":"Bearer demo_access_token"}', true),
'json' => json_decode('{"agendas":[{"name":"Demo Trading Ltd","address":{"street":"Zochova","building_no":"6 - 8","city":"Bratislava","postal_code":"811 03","country":"sk"},"company_id":"12345678","company_tax_id":"1002003000","company_vat_id":null,"home_currency":"EUR","email_alias":"demo-invoices","email_whitelist":"invoices@example.com, finance@example.com","external_id":"EXT-2026-0001","client_id":"demo_client_id"}]}', true)
]);
echo $response->getBody();OkHttpClient client = new OkHttpClient();
RequestBody body = RequestBody.create("{\n \"agendas\": [\n {\n \"name\": \"Demo Trading Ltd\",\n \"address\": {\n \"street\": \"Zochova\",\n \"building_no\": \"6 - 8\",\n \"city\": \"Bratislava\",\n \"postal_code\": \"811 03\",\n \"country\": \"sk\"\n },\n \"company_id\": \"12345678\",\n \"company_tax_id\": \"1002003000\",\n \"company_vat_id\": null,\n \"home_currency\": \"EUR\",\n \"email_alias\": \"demo-invoices\",\n \"email_whitelist\": \"invoices@example.com, finance@example.com\",\n \"external_id\": \"EXT-2026-0001\",\n \"client_id\": \"demo_client_id\"\n }\n ]\n}", MediaType.parse("application/json"));
Request request = new Request.Builder()
.url("https://app.datamolino.com/api/v1_2/agendas/12345")
.addHeader("Content-Type", "application/json")
.addHeader("Authorization", "Bearer demo_access_token")
.method("PUT", body)
.build();
Response response = client.newCall(request).execute();using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Put, "https://app.datamolino.com/api/v1_2/agendas/12345");
request.Headers.Add("Authorization", "Bearer demo_access_token");
request.Content = new StringContent("{\n \"agendas\": [\n {\n \"name\": \"Demo Trading Ltd\",\n \"address\": {\n \"street\": \"Zochova\",\n \"building_no\": \"6 - 8\",\n \"city\": \"Bratislava\",\n \"postal_code\": \"811 03\",\n \"country\": \"sk\"\n },\n \"company_id\": \"12345678\",\n \"company_tax_id\": \"1002003000\",\n \"company_vat_id\": null,\n \"home_currency\": \"EUR\",\n \"email_alias\": \"demo-invoices\",\n \"email_whitelist\": \"invoices@example.com, finance@example.com\",\n \"external_id\": \"EXT-2026-0001\",\n \"client_id\": \"demo_client_id\"\n }\n ]\n}", Encoding.UTF8, "application/json");
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());client := &http.Client{}
req, err := http.NewRequest("PUT", "https://app.datamolino.com/api/v1_2/agendas/12345", strings.NewReader("{\n \"agendas\": [\n {\n \"name\": \"Demo Trading Ltd\",\n \"address\": {\n \"street\": \"Zochova\",\n \"building_no\": \"6 - 8\",\n \"city\": \"Bratislava\",\n \"postal_code\": \"811 03\",\n \"country\": \"sk\"\n },\n \"company_id\": \"12345678\",\n \"company_tax_id\": \"1002003000\",\n \"company_vat_id\": null,\n \"home_currency\": \"EUR\",\n \"email_alias\": \"demo-invoices\",\n \"email_whitelist\": \"invoices@example.com, finance@example.com\",\n \"external_id\": \"EXT-2026-0001\",\n \"client_id\": \"demo_client_id\"\n }\n ]\n}"))
if err != nil { panic(err) }
req.Header.Add("Content-Type", "application/json")
req.Header.Add("Authorization", "Bearer demo_access_token")
res, err := client.Do(req)
if err != nil { panic(err) }
defer res.Body.Close()
body, err := io.ReadAll(res.Body)
if err != nil { panic(err) }
fmt.Println(string(body))import Foundation
var request = URLRequest(url: URL(string: "https://app.datamolino.com/api/v1_2/agendas/12345")!)
request.httpMethod = "PUT"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.setValue("Bearer demo_access_token", forHTTPHeaderField: "Authorization")
request.httpBody = "{\n \"agendas\": [\n {\n \"name\": \"Demo Trading Ltd\",\n \"address\": {\n \"street\": \"Zochova\",\n \"building_no\": \"6 - 8\",\n \"city\": \"Bratislava\",\n \"postal_code\": \"811 03\",\n \"country\": \"sk\"\n },\n \"company_id\": \"12345678\",\n \"company_tax_id\": \"1002003000\",\n \"company_vat_id\": null,\n \"home_currency\": \"EUR\",\n \"email_alias\": \"demo-invoices\",\n \"email_whitelist\": \"invoices@example.com, finance@example.com\",\n \"external_id\": \"EXT-2026-0001\",\n \"client_id\": \"demo_client_id\"\n }\n ]\n}".data(using: .utf8)
let (data, _) = try await URLSession.shared.data(for: request)
print(String(data: data, encoding: .utf8)!)Responses
200 OK
Content type: application/json; charset=utf-8
{
"links": {
"back": {
"href": "https://beta.datamolino.com/api/v1_2/agendas"
},
"self": {
"href": "https://beta.datamolino.com/api/v1_2/agendas/1238?access_token=demo_access_token"
}
},
"agendas": [
{
"links": {
"self": {
"href": "https://beta.datamolino.com/api/v1_2/agendas/1238"
},
"owner": {
"id": 10,
"href": "https://beta.datamolino.com/api/v1_2/users/10",
"type": "users"
}
},
"id": 1238,
"name": "Demo Trading Ltd",
"address": {
"street": "Zochova",
"building_no": "6 - 8",
"city": "Bratislava",
"postal_code": "811 03",
"country": "sk"
},
"company_id": "12345678",
"company_tax_id": "1002003000",
"company_vat_id": "SK1234567890",
"home_currency": "EUR",
"email_alias": "demo-invoices",
"email_whitelist": "invoices@example.com, finance@example.com",
"external_id": "EXT-2026-0001",
"default_view_detail": "summary",
"active_addons": []
}
]
}