SavedViews

GET List saved views

https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views

Get all saved views for the authenticated user with optional filtering and ordering

cURL

curl  https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views \
  -H "Content-Type: application/json"

Go

req, err := http.NewRequest(http.MethodGet, 
  "https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views")
if err != nil {
    print(err)
}
req.Header.Set("Content-Type", "application/json; charset=utf-8")

client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
    print(err)
}

defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
    print(err)
}

fmt.Print(string(body))

Ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views')
req = Net::HTTP::Get.new(uri)
req['Content-Type'] = "application/json"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(req)
end
puts JSON.parse(res.body)

JavaScript

fetch("https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views", {
  method: "GET",
  headers: {
	"Content-Type": "application/json"
  },
})
.then((resp) => resp.json())
.then((json) => {
  console.log(json);
})
.catch(err => console.error(err));

Python

import requests
from base64 import b64encode

data = requests.get('https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views', headers={'content-type': 'application/json'})
print(data.json())

Rust

extern crate tokio;
extern crate serde_json;
use reqwest::{Client};
use reqwest::header::{CONTENT_TYPE};

#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
  let client = Client::new();
  let json = client.request(Method::GET, "https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views".to_string())
  .header(CONTENT_TYPE, "application/json")
  .send()
  .await?
  .json()
  .await?;
  
  println!("{:#?}", json);

  Ok(())
}

Parameters

Path

name	type	required	description
workspace_id	integer	true	Workspace ID

Query

name	type	required	description
name	string	false	Filter saved views by name (partial match)
type	string	false	Filter saved views by type
order_by	string	false	Order by field

Response

200

Name	Type	Description
items	Array of object	-

items

Name	Type	Description
created_at	string	-
deleted_at	string	-
icon_name	string	-
id	integer	-
name	string	-
params	object	-
pinned	boolean	-
toggl_user_id	integer	-
type	string	Valid values: inbox, archive, board, timeline, project, project.tasks, project.board, project.timeline, projects, reports.summary, reports.detailed, reports.utilization, reports.workload, reports.profitability, reports.time-off, reports.time-accounting.
updated_at	string	-
workspace_id	integer	-

params

400

Bad Request

500

Internal Server Error

POST Create a new saved view

https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views

Create a new saved view for the authenticated user

cURL

curl -X POST https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views \
  -H "Content-Type: application/json" \
  -d '\{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\}'

Go

bytes, err := json.Marshal('\{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\}')
if err != nil {
    print(err)
}
req, err := http.NewRequest(http.MethodPost, 
  "https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views", bytes.NewBuffer(bytes))
if err != nil {
    print(err)
}
req.Header.Set("Content-Type", "application/json; charset=utf-8")

client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
    print(err)
}

defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
    print(err)
}

fmt.Print(string(body))

Ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views')
req = Net::HTTP::Post.new(uri)
req['Content-Type'] = "application/json"
req.body = \{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(req)
end
puts JSON.parse(res.body)

JavaScript

fetch("https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views", {
  method: "POST",
  body: \{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\},
  headers: {
	"Content-Type": "application/json"
  },
})
.then((resp) => resp.json())
.then((json) => {
  console.log(json);
})
.catch(err => console.error(err));

Python

import requests
from base64 import b64encode

data = requests.post('https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views', json=\{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\}, headers={'content-type': 'application/json'})
print(data.json())

Rust

extern crate tokio;
extern crate serde_json;
use reqwest::{Client};
use reqwest::header::{CONTENT_TYPE};

#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
  let client = Client::new();
  let json = client.request(Method::POST, "https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views".to_string())
.json(&serde_json::json!(\{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\}))
  .header(CONTENT_TYPE, "application/json")
  .send()
  .await?
  .json()
  .await?;
  
  println!("{:#?}", json);

  Ok(())
}

Parameters

Path

name	type	required	description
workspace_id	integer	true	Workspace ID

Body

Name	Type	Description
icon_name	string	-
name	string	-
params	object	-
pinned	boolean	-
type	string	Valid values: inbox, archive, board, timeline, project, project.tasks, project.board, project.timeline, projects, reports.summary, reports.detailed, reports.utilization, reports.workload, reports.profitability, reports.time-off, reports.time-accounting.

params

Response

201

Created

400

Bad Request

500

Internal Server Error

GET Get a saved view

https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}

Retrieve a single saved view by ID for the authenticated user

cURL

curl  https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id} \
  -H "Content-Type: application/json"

Go

req, err := http.NewRequest(http.MethodGet, 
  "https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}")
if err != nil {
    print(err)
}
req.Header.Set("Content-Type", "application/json; charset=utf-8")

client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
    print(err)
}

defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
    print(err)
}

fmt.Print(string(body))

Ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}')
req = Net::HTTP::Get.new(uri)
req['Content-Type'] = "application/json"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(req)
end
puts JSON.parse(res.body)

JavaScript

fetch("https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}", {
  method: "GET",
  headers: {
	"Content-Type": "application/json"
  },
})
.then((resp) => resp.json())
.then((json) => {
  console.log(json);
})
.catch(err => console.error(err));

Python

import requests
from base64 import b64encode

data = requests.get('https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}', headers={'content-type': 'application/json'})
print(data.json())

Rust

extern crate tokio;
extern crate serde_json;
use reqwest::{Client};
use reqwest::header::{CONTENT_TYPE};

#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
  let client = Client::new();
  let json = client.request(Method::GET, "https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}".to_string())
  .header(CONTENT_TYPE, "application/json")
  .send()
  .await?
  .json()
  .await?;
  
  println!("{:#?}", json);

  Ok(())
}

Parameters

Path

name	type	required	description
workspace_id	integer	true	Workspace ID
id	integer	true	Saved view ID

Response

200

Name	Type	Description
created_at	string	-
deleted_at	string	-
icon_name	string	-
id	integer	-
name	string	-
params	object	-
pinned	boolean	-
toggl_user_id	integer	-
type	string	Valid values: inbox, archive, board, timeline, project, project.tasks, project.board, project.timeline, projects, reports.summary, reports.detailed, reports.utilization, reports.workload, reports.profitability, reports.time-off, reports.time-accounting.
updated_at	string	-
workspace_id	integer	-

params

404

Not Found

500

Internal Server Error

DELETE Delete a saved view

https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}

Delete an existing saved view for the authenticated user

cURL

curl -X DELETE https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id} \
  -H "Content-Type: application/json"

Go

req, err := http.NewRequest(http.MethodPut, 
  "https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}")
if err != nil {
    print(err)
}
req.Header.Set("Content-Type", "application/json; charset=utf-8")

client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
    print(err)
}

defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
    print(err)
}

fmt.Print(string(body))

Ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}')
req = Net::HTTP::Delete.new(uri)
req['Content-Type'] = "application/json"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(req)
end
puts JSON.parse(res.body)

JavaScript

fetch("https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}", {
  method: "DELETE",
  headers: {
	"Content-Type": "application/json"
  },
})
.then((resp) => resp.json())
.then((json) => {
  console.log(json);
})
.catch(err => console.error(err));

Python

import requests
from base64 import b64encode

data = requests.delete('https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}', headers={'content-type': 'application/json'})
print(data.json())

Rust

extern crate tokio;
extern crate serde_json;
use reqwest::{Client};
use reqwest::header::{CONTENT_TYPE};

#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
  let client = Client::new();
  let json = client.request(Method::DELETE, "https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}".to_string())
  .header(CONTENT_TYPE, "application/json")
  .send()
  .await?
  .json()
  .await?;
  
  println!("{:#?}", json);

  Ok(())
}

Parameters

Path

name	type	required	description
workspace_id	integer	true	Workspace ID
id	integer	true	Saved view ID

Response

204

No Content

404

Not Found

500

Internal Server Error

PATCH Update a saved view

https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}

Update an existing saved view for the authenticated user

cURL

curl -X PATCH https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id} \
  -H "Content-Type: application/json" \
  -d '\{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\}'

Go

bytes, err := json.Marshal('\{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\}')
if err != nil {
    print(err)
}
req, err := http.NewRequest(http.MethodGet, 
  "https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}", bytes.NewBuffer(bytes))
if err != nil {
    print(err)
}
req.Header.Set("Content-Type", "application/json; charset=utf-8")

client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
    print(err)
}

defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
    print(err)
}

fmt.Print(string(body))

Ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}')
req = Net::HTTP::Patch.new(uri)
req['Content-Type'] = "application/json"
req.body = \{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(req)
end
puts JSON.parse(res.body)

JavaScript

fetch("https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}", {
  method: "PATCH",
  body: \{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\},
  headers: {
	"Content-Type": "application/json"
  },
})
.then((resp) => resp.json())
.then((json) => {
  console.log(json);
})
.catch(err => console.error(err));

Python

import requests
from base64 import b64encode

data = requests.patch('https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}', json=\{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\}, headers={'content-type': 'application/json'})
print(data.json())

Rust

extern crate tokio;
extern crate serde_json;
use reqwest::{Client};
use reqwest::header::{CONTENT_TYPE};

#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
  let client = Client::new();
  let json = client.request(Method::PATCH, "https://focus.toggl.com/api/workspaces/{workspace_id}/saved-views/{id}".to_string())
.json(&serde_json::json!(\{"icon_name":"string","name":"string","params":\{\},"pinned":"boolean","type":"string"\}))
  .header(CONTENT_TYPE, "application/json")
  .send()
  .await?
  .json()
  .await?;
  
  println!("{:#?}", json);

  Ok(())
}

Parameters

Path

name	type	required	description
workspace_id	integer	true	Workspace ID
id	integer	true	Saved view ID

Body

Name	Type	Description
icon_name	string	-
name	string	-
params	object	-
pinned	boolean	-
type	string	Valid values: inbox, archive, board, timeline, project, project.tasks, project.board, project.timeline, projects, reports.summary, reports.detailed, reports.utilization, reports.workload, reports.profitability, reports.time-off, reports.time-accounting.

params

Response

200

Name	Type	Description
created_at	string	-
deleted_at	string	-
icon_name	string	-
id	integer	-
name	string	-
params	object	-
pinned	boolean	-
toggl_user_id	integer	-
type	string	Valid values: inbox, archive, board, timeline, project, project.tasks, project.board, project.timeline, projects, reports.summary, reports.detailed, reports.utilization, reports.workload, reports.profitability, reports.time-off, reports.time-accounting.
updated_at	string	-
workspace_id	integer	-

params

400

Bad Request

404

Not Found

500

Internal Server Error