Skip to main content
GET
/
v1
/
objects
/
{id}
JavaScript
import Runloop from '@runloop/api-client';

const client = new Runloop({
  bearerToken: process.env['RUNLOOP_API_KEY'], // This is the default and can be omitted
});

const objectView = await client.objects.retrieve('id');

console.log(objectView.id);
{
  "id": "<string>",
  "name": "<string>",
  "create_time_ms": 123,
  "size_bytes": 123,
  "delete_after_time_ms": 123,
  "metadata": {},
  "upload_url": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.runloop.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The unique identifier of the Object to retrieve.

Response

Object retrieved successfully.

An Object represents a stored data entity with metadata.

​
id
string
required

The unique identifier of the Object.

​
name
string
required

The name of the Object.

​
state
enum<string>
required

The current state of the Object.

Available options:
UPLOADING,
READ_ONLY,
DELETED,
ERROR
​
content_type
enum<string>
required

The content type of the Object.

Available options:
unspecified,
text,
binary,
gzip,
tar,
tgz
​
create_time_ms
integer<int64>
required

The creation time of the Object in milliseconds since epoch.

​
size_bytes
integer<int64> | null

The size of the Object content in bytes (null until uploaded).

​
delete_after_time_ms
integer<int64> | null

The time after which the Object will be deleted in milliseconds since epoch.

​
metadata
object

User defined metadata to attach to the Object for organization.

​
upload_url
string | null

Presigned URL for uploading content to S3 (only present on create).