Riferimento API di Flowyer

curl 'https://www.flowyer.it/api/agent/me' \
  -H 'Authorization: Bearer flw_...'

const response = await fetch("https://www.flowyer.it/api/agent/me", {
  headers: {
    "Authorization": "Bearer flw_...",
  },
});
const result = await response.json();

import requests

response = requests.get(
    "https://www.flowyer.it/api/agent/me",
    headers={
        "Authorization": "Bearer flw_...",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "data": {
    "user": {
      "id": 1234,
      "name": "string",
      "language": "string"
    },
    "office": {
      "id": 1234,
      "name": "string",
      "timezone": "string",
      "currency_id": 1234,
      "currency": "string"
    },
    "key": {
      "id": 1234,
      "name": "string",
      "kind": "key",
      "prefix": "string",
      "expires_at": "2026-10-30T09:15:00+01:00",
      "last_used_at": "2026-10-30T09:15:00+01:00"
    },
    "scopes": [
      "string"
    ],
    "available_scopes": [
      "string"
    ],
    "limits": {
      "requests_per_minute": 0,
      "list_max_limit": 0
    },
    "channel": "rest"
  }
}

{
  "error": "invalid_key",
  "message": "The API key is not valid.",
  "message_localized": "La chiave API non è valida.",
  "locale": "it",
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl 'https://www.flowyer.it/api/agent/colleagues?q=Nagy%20P%C3%A9ter' \
  -H 'Authorization: Bearer flw_...'

const response = await fetch("https://www.flowyer.it/api/agent/colleagues?q=Nagy%20P%C3%A9ter", {
  headers: {
    "Authorization": "Bearer flw_...",
  },
});
const result = await response.json();

import requests

response = requests.get(
    "https://www.flowyer.it/api/agent/colleagues?q=Nagy%20P%C3%A9ter",
    headers={
        "Authorization": "Bearer flw_...",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "data": {
    "status": "exact",
    "colleagues": [
      {
        "id": 1234,
        "name": "string",
        "title": "string"
      }
    ],
    "total": 1,
    "truncated": true
  }
}

{
  "error": "scope_missing",
  "message": "This API key does not have the \"colleagues:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Settings > API keys and use it in place of the old one.",
  "message_localized": "Questa chiave API non ha il permesso \"colleagues:read\". I permessi di una chiave esistente non possono essere modificati, quindi il titolare della chiave deve creare in Flowyer, in Impostazioni > Chiavi API, una nuova chiave con questo permesso e usarla al posto di quella vecchia.",
  "locale": "it",
  "details": {
    "required_scope": "colleagues:read"
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl 'https://www.flowyer.it/api/agent/matters?q=2026%2F0025&client_id=512&updated_since=2026-10-01T00%3A00%3A00%2B02%3A00' \
  -H 'Authorization: Bearer flw_...'

const response = await fetch("https://www.flowyer.it/api/agent/matters?q=2026%2F0025&client_id=512&updated_since=2026-10-01T00%3A00%3A00%2B02%3A00", {
  headers: {
    "Authorization": "Bearer flw_...",
  },
});
const result = await response.json();

import requests

response = requests.get(
    "https://www.flowyer.it/api/agent/matters?q=2026%2F0025&client_id=512&updated_since=2026-10-01T00%3A00%3A00%2B02%3A00",
    headers={
        "Authorization": "Bearer flw_...",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "data": [
    {
      "id": 1234,
      "case_number": "2026/0025",
      "subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
      "status": "active",
      "case_type_id": 1234,
      "case_type": "string",
      "responsible_user_id": 1234,
      "responsible": "string",
      "clients": [
        {
          "id": 1234,
          "name": "string"
        }
      ],
      "started_on": "2026-10-30",
      "restricted": true,
      "created_at": "2026-10-30T09:15:00+01:00",
      "updated_at": "2026-10-30T09:15:00+01:00",
      "created_via_api": {
        "kind": "key",
        "key_id": 1234,
        "key_name": "string",
        "user_id": 1234,
        "user": "string",
        "at": "2026-10-30T09:15:00+01:00"
      }
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "total": 1
  }
}

{
  "error": "scope_missing",
  "message": "This API key does not have the \"matters:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Settings > API keys and use it in place of the old one.",
  "message_localized": "Questa chiave API non ha il permesso \"matters:read\". I permessi di una chiave esistente non possono essere modificati, quindi il titolare della chiave deve creare in Flowyer, in Impostazioni > Chiavi API, una nuova chiave con questo permesso e usarla al posto di quella vecchia.",
  "locale": "it",
  "details": {
    "required_scope": "matters:read"
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl 'https://www.flowyer.it/api/agent/matters/resolve?name=ingatlan%20ad%C3%A1sv%C3%A9tel' \
  -H 'Authorization: Bearer flw_...'

const response = await fetch("https://www.flowyer.it/api/agent/matters/resolve?name=ingatlan%20ad%C3%A1sv%C3%A9tel", {
  headers: {
    "Authorization": "Bearer flw_...",
  },
});
const result = await response.json();

import requests

response = requests.get(
    "https://www.flowyer.it/api/agent/matters/resolve?name=ingatlan%20ad%C3%A1sv%C3%A9tel",
    headers={
        "Authorization": "Bearer flw_...",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "data": {
    "status": "exact",
    "matters": [
      {
        "id": 1234,
        "case_number": "2026/0025",
        "subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
        "status": "active",
        "case_type_id": 1234,
        "case_type": "string",
        "responsible_user_id": 1234,
        "responsible": "string",
        "clients": [
          {
            "id": 1234,
            "name": "string"
          }
        ],
        "started_on": "2026-10-30",
        "restricted": true,
        "created_at": "2026-10-30T09:15:00+01:00",
        "updated_at": "2026-10-30T09:15:00+01:00",
        "created_via_api": {
          "kind": "key",
          "key_id": 1234,
          "key_name": "string",
          "user_id": 1234,
          "user": "string",
          "at": "2026-10-30T09:15:00+01:00"
        }
      }
    ],
    "total": 1,
    "truncated": true
  }
}

{
  "error": "scope_missing",
  "message": "This API key does not have the \"matters:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Settings > API keys and use it in place of the old one.",
  "message_localized": "Questa chiave API non ha il permesso \"matters:read\". I permessi di una chiave esistente non possono essere modificati, quindi il titolare della chiave deve creare in Flowyer, in Impostazioni > Chiavi API, una nuova chiave con questo permesso e usarla al posto di quella vecchia.",
  "locale": "it",
  "details": {
    "required_scope": "matters:read"
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl 'https://www.flowyer.it/api/agent/matters/1234' \
  -H 'Authorization: Bearer flw_...'

const response = await fetch("https://www.flowyer.it/api/agent/matters/1234", {
  headers: {
    "Authorization": "Bearer flw_...",
  },
});
const result = await response.json();

import requests

response = requests.get(
    "https://www.flowyer.it/api/agent/matters/1234",
    headers={
        "Authorization": "Bearer flw_...",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "data": {
    "id": 1234,
    "case_number": "2026/0025",
    "subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
    "status": "active",
    "case_type_id": 1234,
    "case_type": "string",
    "responsible_user_id": 1234,
    "responsible": "string",
    "clients": [
      {
        "id": 1234,
        "name": "string"
      }
    ],
    "started_on": "2026-10-30",
    "restricted": true,
    "created_at": "2026-10-30T09:15:00+01:00",
    "updated_at": "2026-10-30T09:15:00+01:00",
    "created_via_api": {
      "kind": "key",
      "key_id": 1234,
      "key_name": "string",
      "user_id": 1234,
      "user": "string",
      "at": "2026-10-30T09:15:00+01:00"
    },
    "description": "string",
    "litigious": true,
    "archived_at": "2026-10-30"
  }
}

{
  "error": "matter_not_visible",
  "message": "The matter 1234 does not exist, is archived, or is not visible to the user who owns this API key.",
  "message_localized": "La pratica 1234 non esiste, è archiviata oppure non è visibile al titolare di questa chiave API.",
  "locale": "it",
  "details": {
    "matter_id": 1234
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl -X POST 'https://www.flowyer.it/api/agent/matters' \
  -H 'Authorization: Bearer flw_...' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
  -d '{
  "subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
  "case_type_id": 1234,
  "client_ids": [
    512
  ],
  "started_on": "2026-10-29"
}'

const response = await fetch("https://www.flowyer.it/api/agent/matters", {
  method: "POST",
  headers: {
    "Authorization": "Bearer flw_...",
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    "subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
    "case_type_id": 1234,
    "client_ids": [
      512
    ],
    "started_on": "2026-10-29"
  }),
});
const result = await response.json();

import uuid

import requests

response = requests.post(
    "https://www.flowyer.it/api/agent/matters",
    headers={
        "Authorization": "Bearer flw_...",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
        "case_type_id": 1234,
        "client_ids": [
            512,
        ],
        "started_on": "2026-10-29",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
  "case_type_id": 1234,
  "client_ids": [
    512
  ],
  "started_on": "2026-10-29"
}

{
  "data": {
    "id": 1234,
    "case_number": "2026/0025",
    "subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
    "status": "active",
    "case_type_id": 1234,
    "case_type": "string",
    "responsible_user_id": 1234,
    "responsible": "string",
    "clients": [
      {
        "id": 1234,
        "name": "string"
      }
    ],
    "started_on": "2026-10-30",
    "restricted": true,
    "created_at": "2026-10-30T09:15:00+01:00",
    "updated_at": "2026-10-30T09:15:00+01:00",
    "created_via_api": {
      "kind": "key",
      "key_id": 1234,
      "key_name": "string",
      "user_id": 1234,
      "user": "string",
      "at": "2026-10-30T09:15:00+01:00"
    },
    "description": "string",
    "litigious": true,
    "archived_at": "2026-10-30"
  },
  "created": true
}

{
  "data": {
    "id": 1234,
    "case_number": "2026/0025",
    "subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
    "status": "active",
    "case_type_id": 1234,
    "case_type": "string",
    "responsible_user_id": 1234,
    "responsible": "string",
    "clients": [
      {
        "id": 1234,
        "name": "string"
      }
    ],
    "started_on": "2026-10-30",
    "restricted": true,
    "created_at": "2026-10-30T09:15:00+01:00",
    "updated_at": "2026-10-30T09:15:00+01:00",
    "created_via_api": {
      "kind": "key",
      "key_id": 1234,
      "key_name": "string",
      "user_id": 1234,
      "user": "string",
      "at": "2026-10-30T09:15:00+01:00"
    },
    "description": "string",
    "litigious": true,
    "archived_at": "2026-10-30"
  },
  "created": false,
  "idempotent_replay": true
}

{
  "error": "validation_failed",
  "message": "The request is invalid. See \"details.fields\" for the field-level errors.",
  "message_localized": "La richiesta non è valida. Gli errori per campo sono in \"details.fields\".",
  "locale": "it",
  "details": {
    "fields": {
      "subject": [
        "Il campo subject è obbligatorio."
      ]
    }
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl -X PATCH 'https://www.flowyer.it/api/agent/matters/1234' \
  -H 'Authorization: Bearer flw_...' \
  -H 'Content-Type: application/json' \
  -d '{
  "expected_updated_at": "2026-10-30T09:15:00+01:00",
  "subject": "string"
}'

const response = await fetch("https://www.flowyer.it/api/agent/matters/1234", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer flw_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "expected_updated_at": "2026-10-30T09:15:00+01:00",
    "subject": "string"
  }),
});
const result = await response.json();

import requests

response = requests.patch(
    "https://www.flowyer.it/api/agent/matters/1234",
    headers={
        "Authorization": "Bearer flw_...",
    },
    json={
        "expected_updated_at": "2026-10-30T09:15:00+01:00",
        "subject": "string",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "expected_updated_at": "2026-10-30T09:15:00+01:00",
  "subject": "string"
}

{
  "data": {
    "id": 1234,
    "case_number": "2026/0025",
    "subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
    "status": "active",
    "case_type_id": 1234,
    "case_type": "string",
    "responsible_user_id": 1234,
    "responsible": "string",
    "clients": [
      {
        "id": 1234,
        "name": "string"
      }
    ],
    "started_on": "2026-10-30",
    "restricted": true,
    "created_at": "2026-10-30T09:15:00+01:00",
    "updated_at": "2026-10-30T09:15:00+01:00",
    "created_via_api": {
      "kind": "key",
      "key_id": 1234,
      "key_name": "string",
      "user_id": 1234,
      "user": "string",
      "at": "2026-10-30T09:15:00+01:00"
    },
    "description": "string",
    "litigious": true,
    "archived_at": "2026-10-30"
  },
  "updated": true
}

{
  "error": "record_conflict",
  "message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
  "message_localized": "Il record è cambiato dall'ultima lettura (qualcuno lo ha modificato). Rileggerlo e riprovare con il nuovo updated_at.",
  "locale": "it",
  "details": {
    "current_updated_at": "2026-10-30T10:42:05+01:00",
    "reason": "modified_since_read"
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl 'https://www.flowyer.it/api/agent/matters/1234/responsibles?limit=25' \
  -H 'Authorization: Bearer flw_...'

const response = await fetch("https://www.flowyer.it/api/agent/matters/1234/responsibles?limit=25", {
  headers: {
    "Authorization": "Bearer flw_...",
  },
});
const result = await response.json();

import requests

response = requests.get(
    "https://www.flowyer.it/api/agent/matters/1234/responsibles?limit=25",
    headers={
        "Authorization": "Bearer flw_...",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "data": [
    {
      "type": "user",
      "user_id": 1234,
      "workgroup_id": 1234,
      "name": "string"
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "total": 1
  }
}

{
  "error": "matter_not_visible",
  "message": "The matter 1234 does not exist, is archived, or is not visible to the user who owns this API key.",
  "message_localized": "La pratica 1234 non esiste, è archiviata oppure non è visibile al titolare di questa chiave API.",
  "locale": "it",
  "details": {
    "matter_id": 1234
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl -X POST 'https://www.flowyer.it/api/agent/matters/1234/responsibles' \
  -H 'Authorization: Bearer flw_...' \
  -H 'Content-Type: application/json' \
  -d '{
  "user_id": 42
}'

const response = await fetch("https://www.flowyer.it/api/agent/matters/1234/responsibles", {
  method: "POST",
  headers: {
    "Authorization": "Bearer flw_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "user_id": 42
  }),
});
const result = await response.json();

import requests

response = requests.post(
    "https://www.flowyer.it/api/agent/matters/1234/responsibles",
    headers={
        "Authorization": "Bearer flw_...",
    },
    json={
        "user_id": 42,
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "user_id": 42
}

{
  "data": {
    "user_id": 1234,
    "name": "string",
    "already_responsible": true,
    "notified": true
  }
}

{
  "error": "validation_failed",
  "message": "The request is invalid. See \"details.fields\" for the field-level errors.",
  "message_localized": "La richiesta non è valida. Gli errori per campo sono in \"details.fields\".",
  "locale": "it",
  "details": {
    "fields": {
      "user_id": [
        "Il campo user id è obbligatorio."
      ]
    }
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl 'https://www.flowyer.it/api/agent/clients?q=Kov%C3%A1cs&limit=25' \
  -H 'Authorization: Bearer flw_...'

const response = await fetch("https://www.flowyer.it/api/agent/clients?q=Kov%C3%A1cs&limit=25", {
  headers: {
    "Authorization": "Bearer flw_...",
  },
});
const result = await response.json();

import requests

response = requests.get(
    "https://www.flowyer.it/api/agent/clients?q=Kov%C3%A1cs&limit=25",
    headers={
        "Authorization": "Bearer flw_...",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "data": [
    {
      "id": 512,
      "name": "Kovács Kft.",
      "is_person": true,
      "email": "info@example.hu",
      "phone": "string",
      "archived": true,
      "recorded_by_user_id": 1234,
      "recorded_by": "string",
      "created_at": "2026-10-30T09:15:00+01:00",
      "updated_at": "2026-10-30T09:15:00+01:00",
      "created_via_api": {
        "kind": "key",
        "key_id": 1234,
        "key_name": "string",
        "user_id": 1234,
        "user": "string",
        "at": "2026-10-30T09:15:00+01:00"
      }
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "total": 1
  }
}

{
  "error": "scope_missing",
  "message": "This API key does not have the \"clients:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Settings > API keys and use it in place of the old one.",
  "message_localized": "Questa chiave API non ha il permesso \"clients:read\". I permessi di una chiave esistente non possono essere modificati, quindi il titolare della chiave deve creare in Flowyer, in Impostazioni > Chiavi API, una nuova chiave con questo permesso e usarla al posto di quella vecchia.",
  "locale": "it",
  "details": {
    "required_scope": "clients:read"
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl 'https://www.flowyer.it/api/agent/clients/resolve?name=J%C3%B3zsi%20ingatlan' \
  -H 'Authorization: Bearer flw_...'

const response = await fetch("https://www.flowyer.it/api/agent/clients/resolve?name=J%C3%B3zsi%20ingatlan", {
  headers: {
    "Authorization": "Bearer flw_...",
  },
});
const result = await response.json();

import requests

response = requests.get(
    "https://www.flowyer.it/api/agent/clients/resolve?name=J%C3%B3zsi%20ingatlan",
    headers={
        "Authorization": "Bearer flw_...",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "data": {
    "status": "exact",
    "matches": [
      {
        "id": 512,
        "name": "Kovács Kft.",
        "is_person": true,
        "email": "info@example.hu",
        "phone": "string",
        "archived": true,
        "recorded_by_user_id": 1234,
        "recorded_by": "string",
        "created_at": "2026-10-30T09:15:00+01:00",
        "updated_at": "2026-10-30T09:15:00+01:00",
        "created_via_api": {
          "kind": "key",
          "key_id": 1234,
          "key_name": "string",
          "user_id": 1234,
          "user": "string",
          "at": "2026-10-30T09:15:00+01:00"
        }
      }
    ],
    "total": 1,
    "truncated": true
  }
}

{
  "error": "scope_missing",
  "message": "This API key does not have the \"clients:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Settings > API keys and use it in place of the old one.",
  "message_localized": "Questa chiave API non ha il permesso \"clients:read\". I permessi di una chiave esistente non possono essere modificati, quindi il titolare della chiave deve creare in Flowyer, in Impostazioni > Chiavi API, una nuova chiave con questo permesso e usarla al posto di quella vecchia.",
  "locale": "it",
  "details": {
    "required_scope": "clients:read"
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl 'https://www.flowyer.it/api/agent/clients/512' \
  -H 'Authorization: Bearer flw_...'

const response = await fetch("https://www.flowyer.it/api/agent/clients/512", {
  headers: {
    "Authorization": "Bearer flw_...",
  },
});
const result = await response.json();

import requests

response = requests.get(
    "https://www.flowyer.it/api/agent/clients/512",
    headers={
        "Authorization": "Bearer flw_...",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "data": {
    "id": 512,
    "name": "Kovács Kft.",
    "is_person": true,
    "email": "info@example.hu",
    "phone": "string",
    "archived": true,
    "recorded_by_user_id": 1234,
    "recorded_by": "string",
    "created_at": "2026-10-30T09:15:00+01:00",
    "updated_at": "2026-10-30T09:15:00+01:00",
    "created_via_api": {
      "kind": "key",
      "key_id": 1234,
      "key_name": "string",
      "user_id": 1234,
      "user": "string",
      "at": "2026-10-30T09:15:00+01:00"
    },
    "address": {
      "zip": "string",
      "city": "string",
      "street": "string"
    },
    "mailing_address": {
      "zip": "string",
      "city": "string",
      "street": "string"
    },
    "tax_number": "string",
    "company_registration_number": "string",
    "representative_name": "string",
    "representative_position": "string",
    "main_activity": "string",
    "nationality_country": "string",
    "note": "string"
  }
}

{
  "error": "not_found",
  "message": "The record was not found, or it is not visible to the user who owns this API key.",
  "message_localized": "Il record non è stato trovato oppure non è visibile al titolare di questa chiave API.",
  "locale": "it",
  "details": {
    "client_id": 512
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl -X POST 'https://www.flowyer.it/api/agent/clients' \
  -H 'Authorization: Bearer flw_...' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
  -d '{
  "name": "Kovács Kft.",
  "email": "info@kovacskft.hu",
  "phone": "+36 1 234 5678",
  "tax_number": "12345678-2-41",
  "company_registration_number": "01-09-123456"
}'

const response = await fetch("https://www.flowyer.it/api/agent/clients", {
  method: "POST",
  headers: {
    "Authorization": "Bearer flw_...",
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    "name": "Kovács Kft.",
    "email": "info@kovacskft.hu",
    "phone": "+36 1 234 5678",
    "tax_number": "12345678-2-41",
    "company_registration_number": "01-09-123456"
  }),
});
const result = await response.json();

import uuid

import requests

response = requests.post(
    "https://www.flowyer.it/api/agent/clients",
    headers={
        "Authorization": "Bearer flw_...",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "name": "Kovács Kft.",
        "email": "info@kovacskft.hu",
        "phone": "+36 1 234 5678",
        "tax_number": "12345678-2-41",
        "company_registration_number": "01-09-123456",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "name": "Kovács Kft.",
  "email": "info@kovacskft.hu",
  "phone": "+36 1 234 5678",
  "tax_number": "12345678-2-41",
  "company_registration_number": "01-09-123456"
}

{
  "data": {
    "id": 512,
    "name": "Kovács Kft.",
    "is_person": true,
    "email": "info@example.hu",
    "phone": "string",
    "archived": true,
    "recorded_by_user_id": 1234,
    "recorded_by": "string",
    "created_at": "2026-10-30T09:15:00+01:00",
    "updated_at": "2026-10-30T09:15:00+01:00",
    "created_via_api": {
      "kind": "key",
      "key_id": 1234,
      "key_name": "string",
      "user_id": 1234,
      "user": "string",
      "at": "2026-10-30T09:15:00+01:00"
    },
    "address": {
      "zip": "string",
      "city": "string",
      "street": "string"
    },
    "mailing_address": {
      "zip": "string",
      "city": "string",
      "street": "string"
    },
    "tax_number": "string",
    "company_registration_number": "string",
    "representative_name": "string",
    "representative_position": "string",
    "main_activity": "string",
    "nationality_country": "string",
    "note": "string"
  },
  "created": true
}

{
  "data": {
    "id": 512,
    "name": "Kovács Kft.",
    "is_person": true,
    "email": "info@example.hu",
    "phone": "string",
    "archived": true,
    "recorded_by_user_id": 1234,
    "recorded_by": "string",
    "created_at": "2026-10-30T09:15:00+01:00",
    "updated_at": "2026-10-30T09:15:00+01:00",
    "created_via_api": {
      "kind": "key",
      "key_id": 1234,
      "key_name": "string",
      "user_id": 1234,
      "user": "string",
      "at": "2026-10-30T09:15:00+01:00"
    },
    "address": {
      "zip": "string",
      "city": "string",
      "street": "string"
    },
    "mailing_address": {
      "zip": "string",
      "city": "string",
      "street": "string"
    },
    "tax_number": "string",
    "company_registration_number": "string",
    "representative_name": "string",
    "representative_position": "string",
    "main_activity": "string",
    "nationality_country": "string",
    "note": "string"
  },
  "created": false,
  "idempotent_replay": true
}

{
  "error": "validation_failed",
  "message": "The request is invalid. See \"details.fields\" for the field-level errors.",
  "message_localized": "La richiesta non è valida. Gli errori per campo sono in \"details.fields\".",
  "locale": "it",
  "details": {
    "fields": {
      "name": [
        "Il campo name è obbligatorio."
      ]
    }
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl -X PATCH 'https://www.flowyer.it/api/agent/clients/1234' \
  -H 'Authorization: Bearer flw_...' \
  -H 'Content-Type: application/json' \
  -d '{
  "expected_updated_at": "2026-10-30T09:15:00+01:00",
  "name": "string"
}'

const response = await fetch("https://www.flowyer.it/api/agent/clients/1234", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer flw_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "expected_updated_at": "2026-10-30T09:15:00+01:00",
    "name": "string"
  }),
});
const result = await response.json();

import requests

response = requests.patch(
    "https://www.flowyer.it/api/agent/clients/1234",
    headers={
        "Authorization": "Bearer flw_...",
    },
    json={
        "expected_updated_at": "2026-10-30T09:15:00+01:00",
        "name": "string",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "expected_updated_at": "2026-10-30T09:15:00+01:00",
  "name": "string"
}

{
  "data": {
    "id": 512,
    "name": "Kovács Kft.",
    "is_person": true,
    "email": "info@example.hu",
    "phone": "string",
    "archived": true,
    "recorded_by_user_id": 1234,
    "recorded_by": "string",
    "created_at": "2026-10-30T09:15:00+01:00",
    "updated_at": "2026-10-30T09:15:00+01:00",
    "created_via_api": {
      "kind": "key",
      "key_id": 1234,
      "key_name": "string",
      "user_id": 1234,
      "user": "string",
      "at": "2026-10-30T09:15:00+01:00"
    },
    "address": {
      "zip": "string",
      "city": "string",
      "street": "string"
    },
    "mailing_address": {
      "zip": "string",
      "city": "string",
      "street": "string"
    },
    "tax_number": "string",
    "company_registration_number": "string",
    "representative_name": "string",
    "representative_position": "string",
    "main_activity": "string",
    "nationality_country": "string",
    "note": "string"
  },
  "updated": true
}

{
  "error": "record_conflict",
  "message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
  "message_localized": "Il record è cambiato dall'ultima lettura (qualcuno lo ha modificato). Rileggerlo e riprovare con il nuovo updated_at.",
  "locale": "it",
  "details": {
    "current_updated_at": "2026-10-30T10:42:05+01:00",
    "reason": "modified_since_read"
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl 'https://www.flowyer.it/api/agent/tasks?deadline_from=2026-11-01&deadline_to=2026-11-30&limit=25' \
  -H 'Authorization: Bearer flw_...'

const response = await fetch("https://www.flowyer.it/api/agent/tasks?deadline_from=2026-11-01&deadline_to=2026-11-30&limit=25", {
  headers: {
    "Authorization": "Bearer flw_...",
  },
});
const result = await response.json();

import requests

response = requests.get(
    "https://www.flowyer.it/api/agent/tasks?deadline_from=2026-11-01&deadline_to=2026-11-30&limit=25",
    headers={
        "Authorization": "Bearer flw_...",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "data": [
    {
      "id": 9876,
      "subject": "Submit the statement of defence",
      "description": "string",
      "deadline": "2026-11-15",
      "priority": 2,
      "status": "open",
      "closed_at": "2026-10-30",
      "matter": {
        "id": 1234,
        "case_number": "string"
      },
      "client": {
        "id": 1234,
        "name": "string"
      },
      "assigned_to_user_id": 1234,
      "assigned_to": "string",
      "created_by_user_id": 1234,
      "created_by": "string",
      "flag_id": 1234,
      "created_at": "2026-10-30T09:15:00+01:00",
      "updated_at": "2026-10-30T09:15:00+01:00",
      "created_via_api": {
        "kind": "key",
        "key_id": 1234,
        "key_name": "string",
        "user_id": 1234,
        "user": "string",
        "at": "2026-10-30T09:15:00+01:00"
      }
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "total": 1
  }
}

{
  "error": "scope_missing",
  "message": "This API key does not have the \"tasks:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Settings > API keys and use it in place of the old one.",
  "message_localized": "Questa chiave API non ha il permesso \"tasks:read\". I permessi di una chiave esistente non possono essere modificati, quindi il titolare della chiave deve creare in Flowyer, in Impostazioni > Chiavi API, una nuova chiave con questo permesso e usarla al posto di quella vecchia.",
  "locale": "it",
  "details": {
    "required_scope": "tasks:read"
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}

curl 'https://www.flowyer.it/api/agent/tasks/9876' \
  -H 'Authorization: Bearer flw_...'

const response = await fetch("https://www.flowyer.it/api/agent/tasks/9876", {
  headers: {
    "Authorization": "Bearer flw_...",
  },
});
const result = await response.json();

import requests

response = requests.get(
    "https://www.flowyer.it/api/agent/tasks/9876",
    headers={
        "Authorization": "Bearer flw_...",
    },
    timeout=30,
)
print(response.status_code, response.json())

{
  "data": {
    "id": 9876,
    "subject": "Submit the statement of defence",
    "description": "string",
    "deadline": "2026-11-15",
    "priority": 2,
    "status": "open",
    "closed_at": "2026-10-30",
    "matter": {
      "id": 1234,
      "case_number": "string"
    },
    "client": {
      "id": 1234,
      "name": "string"
    },
    "assigned_to_user_id": 1234,
    "assigned_to": "string",
    "created_by_user_id": 1234,
    "created_by": "string",
    "flag_id": 1234,
    "created_at": "2026-10-30T09:15:00+01:00",
    "updated_at": "2026-10-30T09:15:00+01:00",
    "created_via_api": {
      "kind": "key",
      "key_id": 1234,
      "key_name": "string",
      "user_id": 1234,
      "user": "string",
      "at": "2026-10-30T09:15:00+01:00"
    }
  }
}

{
  "error": "not_found",
  "message": "The record was not found, or it is not visible to the user who owns this API key.",
  "message_localized": "Il record non è stato trovato oppure non è visibile al titolare di questa chiave API.",
  "locale": "it",
  "details": {
    "task_id": 9876
  },
  "request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}