List Recent Resources

GET

recents

curl --request GET \
  --url https://api.aspect.inc/recents \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aspect.inc/recents', 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.aspect.inc/recents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aspect.inc/recents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aspect.inc/recents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "resources": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "workspace",
      "name": "<string>",
      "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "actions": 0,
      "icon": {
        "type": "emoji",
        "emoji": "<string>",
        "color": "<string>",
        "url": "<string>",
        "upload": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "filename": "<string>",
          "mime_type": "<string>",
          "size_bytes": 123,
          "uploaded": true,
          "created": "2023-11-07T05:31:56Z",
          "updated": "2023-11-07T05:31:56Z",
          "url": "<string>",
          "url_expires_at": "2023-11-07T05:31:56Z"
        }
      }
    }
  ],
  "has_more": true
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

JWT in Authorization header. 'Bearer ' prefix optional.

Query Parameters

workspace_id

string<uuid>

required

Workspace to list recent resources for

limit

integer

default:20

Required range: 1 <= x <= 50

offset

integer

default:0

Required range: x >= 0

exclude_types

enum<string>[]

Resource types to exclude from the results (e.g. workspace, project)

Types of resources in the system hierarchy.

Python enum value (.value) is the lowercase wire format, e.g. "workspace". This is what crosses the JSON boundary.
Python enum name (.name) is the uppercase identifier used as the PostgreSQL ENUM literal, e.g. 'WORKSPACE' — SQLAlchemy uses .name by default for sa.Enum columns, so no DB migration is needed when this pattern is adopted.

Raw SQL comparisons against the resources.type column must use .name (not .value) to match the PG ENUM literal.

Available options:

workspace,

project,

directory,

asset,

symlink,

collection

Response

Successful Response

API response with the user's recently accessed resources.

resources

(WorkspaceResourceInfo · object | ProjectResourceInfo · object | CollectionResourceInfo · object | DirectoryResourceInfo · object | AssetResourceInfo · object)[]

required

Recently accessed resources in most-recent-first order

Lightweight display metadata for a workspace resource.

WorkspaceResourceInfo
ProjectResourceInfo
CollectionResourceInfo
DirectoryResourceInfo
AssetResourceInfo

Show child attributes

has_more

boolean

required

Whether another page of recent resources is available

List Recent Resources

curl --request GET \
  --url https://api.aspect.inc/recents \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aspect.inc/recents', 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.aspect.inc/recents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aspect.inc/recents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aspect.inc/recents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "resources": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "workspace",
      "name": "<string>",
      "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "actions": 0,
      "icon": {
        "type": "emoji",
        "emoji": "<string>",
        "color": "<string>",
        "url": "<string>",
        "upload": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "filename": "<string>",
          "mime_type": "<string>",
          "size_bytes": 123,
          "uploaded": true,
          "created": "2023-11-07T05:31:56Z",
          "updated": "2023-11-07T05:31:56Z",
          "url": "<string>",
          "url_expires_at": "2023-11-07T05:31:56Z"
        }
      }
    }
  ],
  "has_more": true
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Overview

API Endpoints

List Recent Resources

Authorizations

Query Parameters

Response