Skip to content

Update Agenda

Updates information about this Folder (agenda). Folder properties can be updated by Folder (agenda) owner only.

PUT/api/v1_2/agendas/:agenda_id

Updates 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": []
    }
  ]
}
Navigation

Type to search…

↑↓ navigate ↵ select Esc close