Atualizar informações de uma meta
curl --request PUT \
--url https://api.olie.ai/api/management/goals/{goal} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Reuniões de alinhamento",
"description": "Encontros semanais registrados manualmente.",
"type": "manual",
"status": "active",
"start_date": "2026-01-01",
"end_date": "2026-12-31",
"periodicity": 30,
"target": 12,
"unit": "count",
"comparison_mode": "target",
"progress": 0,
"user_id": null,
"funnel_step_id": null,
"children": []
}
'import requests
url = "https://api.olie.ai/api/management/goals/{goal}"
payload = {
"title": "Reuniões de alinhamento",
"description": "Encontros semanais registrados manualmente.",
"type": "manual",
"status": "active",
"start_date": "2026-01-01",
"end_date": "2026-12-31",
"periodicity": 30,
"target": 12,
"unit": "count",
"comparison_mode": "target",
"progress": 0,
"user_id": None,
"funnel_step_id": None,
"children": []
}
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({
title: 'Reuniões de alinhamento',
description: 'Encontros semanais registrados manualmente.',
type: 'manual',
status: 'active',
start_date: '2026-01-01',
end_date: '2026-12-31',
periodicity: 30,
target: 12,
unit: 'count',
comparison_mode: 'target',
progress: 0,
user_id: null,
funnel_step_id: null,
children: []
})
};
fetch('https://api.olie.ai/api/management/goals/{goal}', 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.olie.ai/api/management/goals/{goal}",
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([
'title' => 'Reuniões de alinhamento',
'description' => 'Encontros semanais registrados manualmente.',
'type' => 'manual',
'status' => 'active',
'start_date' => '2026-01-01',
'end_date' => '2026-12-31',
'periodicity' => 30,
'target' => 12,
'unit' => 'count',
'comparison_mode' => 'target',
'progress' => 0,
'user_id' => null,
'funnel_step_id' => null,
'children' => [
]
]),
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.olie.ai/api/management/goals/{goal}"
payload := strings.NewReader("{\n \"title\": \"Reuniões de alinhamento\",\n \"description\": \"Encontros semanais registrados manualmente.\",\n \"type\": \"manual\",\n \"status\": \"active\",\n \"start_date\": \"2026-01-01\",\n \"end_date\": \"2026-12-31\",\n \"periodicity\": 30,\n \"target\": 12,\n \"unit\": \"count\",\n \"comparison_mode\": \"target\",\n \"progress\": 0,\n \"user_id\": null,\n \"funnel_step_id\": null,\n \"children\": []\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.olie.ai/api/management/goals/{goal}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Reuniões de alinhamento\",\n \"description\": \"Encontros semanais registrados manualmente.\",\n \"type\": \"manual\",\n \"status\": \"active\",\n \"start_date\": \"2026-01-01\",\n \"end_date\": \"2026-12-31\",\n \"periodicity\": 30,\n \"target\": 12,\n \"unit\": \"count\",\n \"comparison_mode\": \"target\",\n \"progress\": 0,\n \"user_id\": null,\n \"funnel_step_id\": null,\n \"children\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.olie.ai/api/management/goals/{goal}")
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 \"title\": \"Reuniões de alinhamento\",\n \"description\": \"Encontros semanais registrados manualmente.\",\n \"type\": \"manual\",\n \"status\": \"active\",\n \"start_date\": \"2026-01-01\",\n \"end_date\": \"2026-12-31\",\n \"periodicity\": 30,\n \"target\": 12,\n \"unit\": \"count\",\n \"comparison_mode\": \"target\",\n \"progress\": 0,\n \"user_id\": null,\n \"funnel_step_id\": null,\n \"children\": []\n}"
response = http.request(request)
puts response.read_body{
"response": true,
"goal": {
"id": "9b2d1f4a-3c5e-4a7b-8d9f-1e2c3a4b5c6d",
"title": "Reuniões de alinhamento (revisado)",
"description": "Encontros semanais registrados manualmente.",
"status": "active",
"start_date": "2026-01-01",
"end_date": "2026-12-31",
"periodicity": 30,
"type": "manual",
"user_id": null,
"funnel_step_id": null,
"target": 24,
"unit": "count",
"comparison_mode": "target",
"progress": 6,
"progress_change_percentage": 0,
"percentage": 25,
"is_past_calculable": false,
"created_at": "2026-01-06T14:45:51.000000Z",
"updated_at": "2026-02-11T10:03:27.000000Z",
"deleted_at": null
}
}{
"response": false,
"message": "validation_errors",
"error": "O campo end date deve ser uma data posterior a start date.",
"validation": {
"end_date": [
"O campo end date deve ser uma data posterior a start date."
]
}
}goals
Atualizar informações de uma meta
Atualiza uma meta e recalcula o progresso dela em seguida. Título, tipo, data de início e alvo precisam ser enviados sempre, mesmo quando não mudam; os demais campos omitidos permanecem como estão. A lista children é sincronizada: as metas filhas que não aparecerem nela são desvinculadas.
PUT
/
api
/
management
/
goals
/
{goal}
Atualizar informações de uma meta
curl --request PUT \
--url https://api.olie.ai/api/management/goals/{goal} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Reuniões de alinhamento",
"description": "Encontros semanais registrados manualmente.",
"type": "manual",
"status": "active",
"start_date": "2026-01-01",
"end_date": "2026-12-31",
"periodicity": 30,
"target": 12,
"unit": "count",
"comparison_mode": "target",
"progress": 0,
"user_id": null,
"funnel_step_id": null,
"children": []
}
'import requests
url = "https://api.olie.ai/api/management/goals/{goal}"
payload = {
"title": "Reuniões de alinhamento",
"description": "Encontros semanais registrados manualmente.",
"type": "manual",
"status": "active",
"start_date": "2026-01-01",
"end_date": "2026-12-31",
"periodicity": 30,
"target": 12,
"unit": "count",
"comparison_mode": "target",
"progress": 0,
"user_id": None,
"funnel_step_id": None,
"children": []
}
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({
title: 'Reuniões de alinhamento',
description: 'Encontros semanais registrados manualmente.',
type: 'manual',
status: 'active',
start_date: '2026-01-01',
end_date: '2026-12-31',
periodicity: 30,
target: 12,
unit: 'count',
comparison_mode: 'target',
progress: 0,
user_id: null,
funnel_step_id: null,
children: []
})
};
fetch('https://api.olie.ai/api/management/goals/{goal}', 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.olie.ai/api/management/goals/{goal}",
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([
'title' => 'Reuniões de alinhamento',
'description' => 'Encontros semanais registrados manualmente.',
'type' => 'manual',
'status' => 'active',
'start_date' => '2026-01-01',
'end_date' => '2026-12-31',
'periodicity' => 30,
'target' => 12,
'unit' => 'count',
'comparison_mode' => 'target',
'progress' => 0,
'user_id' => null,
'funnel_step_id' => null,
'children' => [
]
]),
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.olie.ai/api/management/goals/{goal}"
payload := strings.NewReader("{\n \"title\": \"Reuniões de alinhamento\",\n \"description\": \"Encontros semanais registrados manualmente.\",\n \"type\": \"manual\",\n \"status\": \"active\",\n \"start_date\": \"2026-01-01\",\n \"end_date\": \"2026-12-31\",\n \"periodicity\": 30,\n \"target\": 12,\n \"unit\": \"count\",\n \"comparison_mode\": \"target\",\n \"progress\": 0,\n \"user_id\": null,\n \"funnel_step_id\": null,\n \"children\": []\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.olie.ai/api/management/goals/{goal}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Reuniões de alinhamento\",\n \"description\": \"Encontros semanais registrados manualmente.\",\n \"type\": \"manual\",\n \"status\": \"active\",\n \"start_date\": \"2026-01-01\",\n \"end_date\": \"2026-12-31\",\n \"periodicity\": 30,\n \"target\": 12,\n \"unit\": \"count\",\n \"comparison_mode\": \"target\",\n \"progress\": 0,\n \"user_id\": null,\n \"funnel_step_id\": null,\n \"children\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.olie.ai/api/management/goals/{goal}")
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 \"title\": \"Reuniões de alinhamento\",\n \"description\": \"Encontros semanais registrados manualmente.\",\n \"type\": \"manual\",\n \"status\": \"active\",\n \"start_date\": \"2026-01-01\",\n \"end_date\": \"2026-12-31\",\n \"periodicity\": 30,\n \"target\": 12,\n \"unit\": \"count\",\n \"comparison_mode\": \"target\",\n \"progress\": 0,\n \"user_id\": null,\n \"funnel_step_id\": null,\n \"children\": []\n}"
response = http.request(request)
puts response.read_body{
"response": true,
"goal": {
"id": "9b2d1f4a-3c5e-4a7b-8d9f-1e2c3a4b5c6d",
"title": "Reuniões de alinhamento (revisado)",
"description": "Encontros semanais registrados manualmente.",
"status": "active",
"start_date": "2026-01-01",
"end_date": "2026-12-31",
"periodicity": 30,
"type": "manual",
"user_id": null,
"funnel_step_id": null,
"target": 24,
"unit": "count",
"comparison_mode": "target",
"progress": 6,
"progress_change_percentage": 0,
"percentage": 25,
"is_past_calculable": false,
"created_at": "2026-01-06T14:45:51.000000Z",
"updated_at": "2026-02-11T10:03:27.000000Z",
"deleted_at": null
}
}{
"response": false,
"message": "validation_errors",
"error": "O campo end date deve ser uma data posterior a start date.",
"validation": {
"end_date": [
"O campo end date deve ser uma data posterior a start date."
]
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
ID (UUID) da meta.
Body
application/json
Dados da meta. Campos fora desta lista são ignorados. Apesar de ser uma atualização, title, type, start_date e target precisam ser enviados sempre; os demais campos omitidos mantêm o valor atual e children, quando omitido, esvazia a composição.
Título da meta. Até 90 caracteres.
Maximum string length:
90Tipo da meta, que define como o progresso é apurado: manual (informado à mão), projects_created (projetos criados), projects_created_by_user (projetos criados por um usuário), funnel_steps_links (entradas em uma etapa de funil), funnel_steps_links_by_user (entradas em uma etapa de funil feitas por um usuário) e composite (soma do progresso das metas filhas).
Available options:
manual, projects_created, projects_created_by_user, funnel_steps_links, funnel_steps_links_by_user, composite Data de início da apuração, no formato YYYY-MM-DD.
Valor alvo da meta, na unidade indicada em unit. Mínimo 1.
Required range:
x >= 1Descrição livre da meta. Até 255 caracteres.
Maximum string length:
255Situação da meta: active (em apuração), inactive (pausada, sem cálculo automático) ou completed (encerrada). Quando omitido na criação, a meta nasce inactive.
Available options:
active, inactive, completed Usuário ao qual a meta fica restrita. Obrigatório nos tipos projects_created_by_user e funnel_steps_links_by_user e proibido nos demais (envie nulo). O usuário precisa fazer parte da empresa.
Etapa de funil apurada pela meta. Obrigatório nos tipos funnel_steps_links e funnel_steps_links_by_user e proibido nos demais (envie nulo).
Data de término da apuração, no formato YYYY-MM-DD. Precisa ser posterior a start_date. Nulo deixa a meta sem prazo final.
Tamanho de cada período de apuração, em dias (0 a 365). Use 0 para apurar o intervalo inteiro de uma vez, sem quebrar em períodos.
Required range:
0 <= x <= 365Unidade do alvo e do progresso: count (quantidade), currency (valor monetário) ou percentage (porcentagem). Padrão count.
Available options:
count, currency, percentage Leitura do alvo: target quando a meta é atingir o valor, limit quando a meta é não ultrapassá-lo. Padrão target.
Available options:
target, limit Progresso da meta. Só é aceito (e passa a ser obrigatório) em metas do tipo manual com status active; nos demais casos é ignorado, porque o progresso é calculado pelo sistema.
Required range:
x >= 0IDs das metas que compõem esta meta. Obrigatório no tipo composite e proibido nos demais (envie uma lista vazia). Não aceita IDs repetidos, nem a própria meta ou alguma de suas metas-pai, para não criar ciclo.
ID de uma meta da mesma empresa que entra na composição.
Was this page helpful?