Skip to content
Website

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

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"
    }
  ]
}'

HTTP

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"
    }
  ]
}

JavaScript Fetch

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();

Node.js Axios

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);

Python Requests

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())

Ruby Net::HTTP

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)

Ruby on Rails

# 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 Guzzle

<?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();

Java OkHttp

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();

C# HttpClient

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());

Go Native

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))

Swift URLSession

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

Type to search…

↑↓ navigate↵ selectEsc close