logo
API docs by Redocly

Roboto REST API (1.0.0)

Download OpenAPI specification:Download

Create, read, update, and delete Roboto resources over HTTP. This API is used by both the Roboto web application and the Roboto SDK.

actions

Create, read, and modify entities within Roboto's 'actions' domain

create_action

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
name
required
string (Name)
ComputeRequirements (object) or null
Default: null
ContainerParameters (object) or null
Default: null
Description (string) or Description (null) (Description)
Default: null
ActionReference (object) or null
Default: null
object (Metadata)
Array of objects (Parameters)
Requires Downloaded Inputs (boolean) or Requires Downloaded Inputs (null) (Requires Downloaded Inputs)
Default: null
Short Description (string) or Short Description (null) (Short Description)
Default: null
tags
Array of strings (Tags)
Timeout (integer) or Timeout (null) (Timeout)
Default: null
Uri (string) or Uri (null) (Uri)
Default: null

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "compute_requirements": null,
  • "container_parameters": null,
  • "description": null,
  • "inherits": null,
  • "metadata": { },
  • "parameters": [
    ],
  • "requires_downloaded_inputs": null,
  • "short_description": null,
  • "tags": [
    ],
  • "timeout": null,
  • "uri": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_action

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
name
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_action

Access control

  • requires_resource_owner_member
Authorizations:
http
path Parameters
name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
ComputeRequirements (object) or Compute Requirements (null) or Compute Requirements (null) (Compute Requirements)
ContainerParameters (object) or Container Parameters (null) or Container Parameters (null) (Container Parameters)
Description (string) or Description (null) or Description (null) (Description)
ActionReference (object) or Inherits (null) or Inherits (null) (Inherits)
MetadataChangeset (object) or Metadata Changeset (null) (Metadata Changeset)
ActionParameterChangeset (object) or Parameter Changeset (null) (Parameter Changeset)
Uri (string) or Uri (null) or Uri (null) (Uri)
Short Description (string) or Short Description (null) or Short Description (null) (Short Description)
Timeout (integer) or Timeout (null) or Timeout (null) (Timeout)
Requires Downloaded Inputs (boolean) or Requires Downloaded Inputs (null) (Requires Downloaded Inputs)

Responses

Request samples

Content type
application/json
{
  • "compute_requirements": {
    },
  • "container_parameters": {
    },
  • "description": "string",
  • "inherits": {
    },
  • "metadata_changeset": {
    },
  • "parameter_changeset": {
    },
  • "uri": "string",
  • "short_description": "string",
  • "timeout": 0,
  • "requires_downloaded_inputs": true
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_action

Access control

  • requires_resource_owner_member
  • deny_actions
Authorizations:
http
path Parameters
name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

set_action_accessibility

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
accessibility
required
string (Accessibility)
Enum: "organization" "action_hub"

Controls who can query for and invoke an action.

Accessibility levels determine the visibility and usability of actions within the Roboto platform. Actions can be private to an organization or published publicly in the Action Hub.

Future accessibility levels may include: "user" and/or "team".

Digest (string) or Digest (null) (Digest)
Default: null

Responses

Request samples

Content type
application/json
{
  • "accessibility": "organization",
  • "digest": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

invoke

Access control

  • requires_org
  • requires_resource_owner
  • deny_actions
Authorizations:
http
path Parameters
name
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
ComputeRequirements (object) or null
Default: null
ContainerParameters (object) or null
Default: null
data_source_id
required
string (Data Source Id)
data_source_type
required
string (InvocationDataSourceType)
Value: "Dataset"

Source of data for an action's input binding.

Defines the type of data source that provides input data to an action invocation. Currently supports datasets, with potential for future expansion to other data source types.

Idempotency Id (string) or Idempotency Id (null) (Idempotency Id)
Default: null
input_data
required
Array of strings (Input Data)
InvocationInput (object) or null
Default: null
invocation_source
required
string (InvocationSource)
Enum: "Trigger" "Manual"

Method by which an invocation was run

Invocation Source Id (string) or Invocation Source Id (null) (Invocation Source Id)
Default: null
Parameter Values (object) or Parameter Values (null) (Parameter Values)
Default: null
Timeout (integer) or Timeout (null) (Timeout)
Default: null
InvocationUploadDestination (object) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "compute_requirement_overrides": null,
  • "container_parameter_overrides": null,
  • "data_source_id": "string",
  • "data_source_type": "Dataset",
  • "idempotency_id": null,
  • "input_data": [
    ],
  • "rich_input_data": null,
  • "invocation_source": "Trigger",
  • "invocation_source_id": null,
  • "parameter_values": null,
  • "timeout": null,
  • "upload_destination": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_distinct_action_tags_for_org

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_distinct_action_tags_for_actionhub

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_invocation_by_id

Authorizations:
http
path Parameters
invocation_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

cancel_invocation

Authorizations:
http
path Parameters
invocation_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

set_invocation_container_info

Authorizations:
http
path Parameters
invocation_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
image_digest
required
string (Image Digest)

Responses

Request samples

Content type
application/json
{
  • "image_digest": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_invocation_ecs_task_info

Authorizations:
http
path Parameters
invocation_id
required
string
query Parameters
required
string or null
required
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": { }
}

heartbeat_invocation

Authorizations:
http
path Parameters
invocation_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_invocation_ecs_logger_creds

Authorizations:
http
path Parameters
invocation_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": { }
}

get_invocation_logs

Paginated logs for an invocation that has finished running. To stream logs for an invocation that has not finished running, use the /.../logs/stream endpoint.

Authorizations:
http
path Parameters
invocation_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

set_invocation_logs_location

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
invocation_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
bucket
required
string (Bucket)
prefix
required
string (Prefix)

Responses

Request samples

Content type
application/json
{
  • "bucket": "string",
  • "prefix": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

stream_invocation_logs

Stream of logs for an invocation that has not finished running.

Authorizations:
http
path Parameters
invocation_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_invocation_status

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
invocation_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
status
required
integer (InvocationStatus)
Enum: 0 1 2 3 4 5 997 998 999

Invocation status enum

detail
required
string (Detail)

Responses

Request samples

Content type
application/json
{
  • "status": 0,
  • "detail": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

batch_cancel_all_active_invocations_for_org

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Created Before (string) or Created Before (null) (Created Before)
Default: null

Responses

Request samples

Content type
application/json
{
  • "created_before": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_invocation_stats_for_org

Access control

  • requires_org
Authorizations:
http
query Parameters
start_time
required
string <date-time>

ISO 8601 datetime string

end_time
required
string <date-time>

ISO 8601 datetime string

header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

query_invocations

Access control

  • requires_resource_owner_or_admin
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Condition (object) or ConditionGroup (object) or Condition (null) (Condition)
Default: null
limit
integer (Limit)
Default: 1000
After (string) or After (null) (After)
Default: null
Sort By (string) or Sort By (null) (Sort By)
Default: null
SortDirection (string) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "condition": null,
  • "limit": 1000,
  • "after": null,
  • "sort_by": null,
  • "sort_direction": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_scheduling_stats

Access control

  • roboto_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_action_metadata_keys_for_org

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

query_actions

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Condition (object) or ConditionGroup (object) or Condition (null) (Condition)
Default: null
limit
integer (Limit)
Default: 1000
After (string) or After (null) (After)
Default: null
Sort By (string) or Sort By (null) (Sort By)
Default: null
SortDirection (string) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "condition": null,
  • "limit": 1000,
  • "after": null,
  • "sort_by": null,
  • "sort_direction": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

query_actions_on_action_hub

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Condition (object) or ConditionGroup (object) or Condition (null) (Condition)
Default: null
limit
integer (Limit)
Default: 1000
After (string) or After (null) (After)
Default: null
Sort By (string) or Sort By (null) (Sort By)
Default: null
SortDirection (string) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "condition": null,
  • "limit": 1000,
  • "after": null,
  • "sort_by": null,
  • "sort_direction": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_action_tags_for_org

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

admin

Create, read, and modify entities within Roboto's 'admin' domain

get_admin_chats

Access control

  • roboto_admin_only
Authorizations:
http
query Parameters
string or null
string or null
string or null
string or null
limit
number
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_migrations

Access control

  • roboto_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_per_action_invocation_stats

Access control

  • roboto_admin_only
Authorizations:
http
query Parameters
start_time
number
end_time
number
limit
number
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

ai

Create, read, and modify entities within Roboto's 'ai' domain

list_chats_for_user

Authorizations:
http
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_chat_by_id

Authorizations:
http
path Parameters
chat_id
required
string
query Parameters
load_messages
boolean
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_chat_delta

Authorizations:
http
path Parameters
chat_id
required
string
query Parameters
next_token
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

send_message_to_chat

Access control

  • requires_premium_org
Authorizations:
http
path Parameters
chat_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
ClientViewingContext (object) or null
Default: null
AgentMessage (object) or null
Default: null
Array of Client Tools (objects) or Client Tools (null) (Client Tools)
Default: null
AnalysisScope (object) or null
Default: null
Array of Goals (any) or Goals (null) (Goals)
Default: null

Responses

Request samples

Content type
application/json
{
  • "client_context": null,
  • "message": null,
  • "client_tools": null,
  • "analysis_scope": null,
  • "goals": null
}

Response samples

Content type
application/json
{
  • "data": null
}

get_tool_details_by_id

Authorizations:
http
path Parameters
chat_id
required
string
tool_use_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

collections

Create, read, and modify entities within Roboto's 'collections' domain

get_collection_access

Authorizations:
http
path Parameters
collection_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

edit_collection_access

Authorizations:
http
path Parameters
collection_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Array of objects (Add)
Array of objects (Remove)

Responses

Request samples

Content type
application/json
{
  • "add": [
    ],
  • "remove": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

create_collection

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Description (string) or Description (null) (Description)
Default: null
Name (string) or Name (null) (Name)
Default: null
resource_type
string (CollectionResourceType)
Default: "file"
Enum: "dataset" "file"

Type of resource added to a collection

Array of Resources (objects) or Resources (null) (Resources)
Default: null
Array of Tags (strings) or Tags (null) (Tags)
Default: null

Responses

Request samples

Content type
application/json
{
  • "description": null,
  • "name": null,
  • "resource_type": "dataset",
  • "resources": null,
  • "tags": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_collection

Authorizations:
http
path Parameters
collection_id
required
string
query Parameters
string or null
content_mode
string
Enum: "summary_only" "references" "full"

Desired content mode for representing a collection

header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_collection

Authorizations:
http
path Parameters
collection_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Array of Add Resources (objects) or Add Resources (null) (Add Resources)
Array of Add Tags (strings) or Add Tags (null) (Add Tags)
Description (string) or Description (null) or Description (null) (Description)
Name (string) or Name (null) or Name (null) (Name)
Array of Remove Resources (objects) or Remove Resources (null) (Remove Resources)
Array of Remove Tags (strings) or Remove Tags (null) (Remove Tags)

Responses

Request samples

Content type
application/json
{
  • "add_resources": [
    ],
  • "add_tags": [
    ],
  • "description": "string",
  • "name": "string",
  • "remove_resources": [
    ],
  • "remove_tags": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_collection

Authorizations:
http
path Parameters
collection_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_collection_changes

Authorizations:
http
path Parameters
collection_id
required
string
query Parameters
string or null
string or null
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

search_collections

Access control

  • requires_resource_owner
Authorizations:
http
query Parameters
content_mode
string
Enum: "summary_only" "references" "full"

Desired content mode for representing a collection

header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Condition (object) or ConditionGroup (object) or Condition (null) (Condition)
Default: null
limit
integer (Limit)
Default: 1000
After (string) or After (null) (After)
Default: null
Sort By (string) or Sort By (null) (Sort By)
Default: null
SortDirection (string) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "condition": null,
  • "limit": 1000,
  • "after": null,
  • "sort_by": null,
  • "sort_direction": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_collection_tags_for_org

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

comments

Create, read, and modify entities within Roboto's 'comments' domain

create_comment

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
entity_type
required
string (CommentEntityType)
Enum: "action" "collection" "dataset" "file" "invocation" "trigger"

Enumeration of Roboto platform entities that support comments.

This enum defines the types of resources in the Roboto platform that can have comments attached to them. Each value corresponds to a specific domain entity type.

entity_id
required
string (Entity Id)
comment_text
required
string (Comment Text)

Responses

Request samples

Content type
application/json
{
  • "entity_type": "action",
  • "entity_id": "string",
  • "comment_text": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_comment_by_id

Access control

  • requires_org
Authorizations:
http
path Parameters
comment_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_comment

Access control

  • requires_org
Authorizations:
http
path Parameters
comment_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
comment_text
required
string (Comment Text)

Responses

Request samples

Content type
application/json
{
  • "comment_text": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_comment

Access control

  • requires_org
Authorizations:
http
path Parameters
comment_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_comments_for_entity

Access control

  • requires_org
Authorizations:
http
path Parameters
entity_type
required
string
entity_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_recent_comments

Access control

  • requires_org
Authorizations:
http
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_comments_for_entity_type

Access control

  • requires_org
Authorizations:
http
path Parameters
entity_type
required
string
Enum: "action" "collection" "dataset" "file" "invocation" "trigger"

Enumeration of Roboto platform entities that support comments.

This enum defines the types of resources in the Roboto platform that can have comments attached to them. Each value corresponds to a specific domain entity type.

query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_comments_for_user

Access control

  • requires_resource_owner_member
Authorizations:
http
path Parameters
user_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

config

Create, read, and modify entities within Roboto's 'config' domain

get_org_config

Authorizations:
http
path Parameters
org_id
required
string
key
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

set_org_config

Authorizations:
http
path Parameters
org_id
required
string
key
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
value
required
any (Value)

Responses

Request samples

Content type
application/json
{
  • "value": null
}

Response samples

Content type
application/json
{
  • "data": null
}

get_user_config

Authorizations:
http
path Parameters
key
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

set_user_config

Authorizations:
http
path Parameters
key
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
value
required
any (Value)

Responses

Request samples

Content type
application/json
{
  • "value": null
}

Response samples

Content type
application/json
{
  • "data": null
}

update_user_org_config

Update user config with org-specific context.

This endpoint handles org-scoped user configuration updates. Currently supports:

  • dataset_search_table_preferences: Merges partial table preferences with existing config
  • file_search_table_preferences: Merges partial table preferences with existing config
  • topic_search_table_preferences: Merges partial table preferences with existing config
  • message_path_search_table_preferences: Merges partial table preferences with existing config
  • event_search_table_preferences: Merges partial table preferences with existing config

Args: org_id: Organization ID to scope the update key: Config key (URL-encoded) request: Request body containing partial table preferences

Returns: GetConfigResponse with the updated/merged config value

Authorizations:
http
path Parameters
org_id
required
string
key
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
object (Preferences)

Responses

Request samples

Content type
application/json
{
  • "preferences": { }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

datasets

Create, read, and modify entities within Roboto's 'datasets' domain

create_dataset

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Description (string) or Description (null) (Description)
Default: null

An optional human-readable description for this dataset.

Device Id (string) or Device Id (null) (Device Id)
Default: null

The ID of the device which created this dataset, if applicable.

Name (string) or Name (null) (Name)
Default: null

A short name for this dataset. Must be under 120 characters or less.

object (Metadata)

Initial key-value pairs to associate with this dataset for discovery and search, e.g. { 'softwareVersion': '3.1.4' }

tags
Array of strings (Tags)

Initial tags to associate with this dataset for discovery and search, e.g. ['sunny', 'campaign5']

Responses

Request samples

Content type
application/json
{
  • "description": null,
  • "device_id": null,
  • "name": null,
  • "metadata": { },
  • "tags": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_dataset

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_dataset

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
MetadataChangeset (object) or Metadata Changeset (null) (Metadata Changeset)
Description (string) or Description (null) or Description (null) (Description)
Device Id (string) or Device Id (null) or Device Id (null) (Device Id)
Name (string) or Name (null) or Name (null) (Name)

Responses

Request samples

Content type
application/json
{
  • "metadata_changeset": {
    },
  • "description": "string",
  • "device_id": "string",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_dataset

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_dataset_access

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

edit_dataset_access

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Array of objects (Add)
Array of objects (Remove)

Responses

Request samples

Content type
application/json
{
  • "add": [
    ],
  • "remove": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

create_directory

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
name
required
string (Name)
error_if_exists
boolean (Error If Exists)
Default: false
Parent Path (string) or Parent Path (null) (Parent Path)
Default: null
Origination (string) or Origination (null) (Origination)
Default: null
create_intermediate_dirs
boolean (Create Intermediate Dirs)
Default: false

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "error_if_exists": false,
  • "parent_path": null,
  • "origination": null,
  • "create_intermediate_dirs": false
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

rename_directory

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
new_path
required
string (New Path)
old_path
required
string (Old Path)

Responses

Request samples

Content type
application/json
{
  • "new_path": "string",
  • "old_path": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

list_events

Authorizations:
http
path Parameters
dataset_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

list_files

Authorizations:
http
path Parameters
dataset_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
One of
Array
string

Responses

Request samples

Content type
application/json
null

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_directories

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
directory_paths
required
Array of strings (Directory Paths)

Responses

Request samples

Content type
application/json
{
  • "directory_paths": [
    ]
}

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_directory_child_count

Authorizations:
http
path Parameters
dataset_id
required
string
query Parameters
directory_path
required
string
show_hidden_files
boolean
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": 0
}

get_directory_contents

Authorizations:
http
path Parameters
dataset_id
required
string
query Parameters
directory_path
required
string
page_size
number
boolean or null
string or null
string or null
string or null
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": { }
}

get_directory_file_extensions

Authorizations:
http
path Parameters
dataset_id
required
string
query Parameters
directory_path
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

move_nodes

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
Array of objects (Operations)

Responses

Request samples

Content type
application/json
{
  • "operations": [
    ]
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

query_dataset_files

Execute a query against files within a specific dataset.

Consistency: Eventually Consistent (for API version >= 2026-03-13)

  • Clients using API version < 2026-03-13: Strongly consistent reads
  • Clients using API version >= 2026-03-13: Eventually consistent reads
  • Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability. Results may not immediately reflect very recent writes. If you've just created or updated files and don't see them in the results, retry after a brief delay.

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Page Token (string) or Page Token (null) (Page Token)
Default: null
Array of Include Patterns (strings) or Include Patterns (null) (Include Patterns)
Default: null
Array of Exclude Patterns (strings) or Exclude Patterns (null) (Exclude Patterns)
Default: null
Limit (integer) or Limit (null) (Limit)
Default: null
Sort By (string) or Sort By (null) (Sort By)
Default: null
Sort Direction (string) or Sort Direction (null) (Sort Direction)
Default: null

Responses

Request samples

Content type
application/json
{
  • "page_token": null,
  • "include_patterns": null,
  • "exclude_patterns": null,
  • "limit": null,
  • "sort_by": null,
  • "sort_direction": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

batch_cancel_active_invocations_for_dataset

Access control

  • requires_resource_owner_or_admin
Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_active_invocation_count

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": 0
}

list_dataset_sessions

Authorizations:
http
path Parameters
dataset_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_dataset_summary

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

generate_dataset_summary

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
One of
Common Knowledge (string) or Common Knowledge (null) (Common Knowledge)
Default: null
User Prompt Guidelines (string) or User Prompt Guidelines (null) (User Prompt Guidelines)
Default: null

Responses

Request samples

Content type
application/json
Example
{
  • "common_knowledge": null,
  • "user_prompt_guidelines": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

set_dataset_summary

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
summary
required
string (Summary)

Responses

Request samples

Content type
application/json
{
  • "summary": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

list_topics

List topics in a dataset.

Consistency: Eventually Consistent (for API version >= 2026-03-13)

  • Clients using API version < 2026-03-13: Strongly consistent reads
  • Clients using API version >= 2026-03-13: Eventually consistent reads
  • Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability. Results may not immediately reflect very recent writes. If you've just created or updated topics and don't see them in the results, retry after a brief delay.

Authorizations:
http
path Parameters
dataset_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_dataset_trigger_evaluations_count

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": 0
}

create_dataset_if_not_exists

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
match_roboql_query
required
string (Match Roboql Query)
required
object (CreateDatasetRequest)

Request payload for creating a new dataset.

Used to specify the initial properties of a dataset during creation, including optional metadata, tags, name, and description.

Responses

Request samples

Content type
application/json
{
  • "match_roboql_query": "string",
  • "create_request": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_credentials

Authorizations:
http
path Parameters
dataset_id
required
string
query Parameters
mode
string
Enum: "ReadOnly" "ReadWrite"

Enum for permission levels of a Roboto resource. It is a best practice to only request/use the minimum permissions required for a given operation.

For example:

  • When listing files associated with a dataset or pulling a container image hosted in Roboto's registry, use ReadOnly permissions.
  • When adding files to a dataset or pushing a container image to Roboto's registry, use ReadWrite permissions.
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_dataset_metadata_keys_for_org

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

query_datasets

Execute a query against datasets.

Consistency: Eventually Consistent (for API version >= 2026-03-13)

  • Clients using API version < 2026-03-13: Strongly consistent reads
  • Clients using API version >= 2026-03-13: Eventually consistent reads
  • Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability. Results may not immediately reflect very recent writes. If you've just created or updated datasets and don't see them in the results, retry after a brief delay.

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Condition (object) or ConditionGroup (object) or Condition (null) (Condition)
Default: null
limit
integer (Limit)
Default: 1000
After (string) or After (null) (After)
Default: null
Sort By (string) or Sort By (null) (Sort By)
Default: null
SortDirection (string) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "condition": null,
  • "limit": 1000,
  • "after": null,
  • "sort_by": null,
  • "sort_direction": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_dataset_tags_for_org

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

begin_single_file_upload

Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Origination (string) or Origination (null) (Origination)
Default: null

Additional information about what uploaded the file, e.g. roboto client v1.0.0.

file_path
required
string (File Path)

The destination path to upload the file to in the dataset, e.g. recording.bagor path/to/metadata.json.

file_size
required
integer (File Size)

The size of the file in bytes.

Responses

Request samples

Content type
application/json
{
  • "origination": null,
  • "file_path": "string",
  • "file_size": 0
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

complete_single_file_upload

Authorizations:
http
path Parameters
dataset_id
required
string
upload_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": null
}

devices

Create, read, and modify entities within Roboto's 'devices' domain

create_device

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
device_id
required
string (Device Id)
Org Id (string) or Org Id (null) (Org Id)
Default: null
object (Metadata)

Initial key-value pairs to associate with this device for discovery and search, e.g. { 'model': 'mk2', 'serial_number': 'SN001234' }

tags
Array of strings (Tags)

Initial tags to associate with this device for discovery and search, e.g. ['production', 'warehouse-a']

Responses

Request samples

Content type
application/json
{
  • "device_id": "string",
  • "org_id": null,
  • "metadata": { },
  • "tags": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_device_by_id

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
device_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_device_by_id

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
device_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
MetadataChangeset (object) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "metadata_changeset": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_device_by_id

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
device_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

list_device_sessions

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
device_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_tokens_for_device

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
device_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

create_token_for_device

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
device_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Array of Api Scopes (strings) or Api Scopes (null) (Api Scopes)
Default: null

Optional set of API scopes to grant this token.

Description (string) or Description (null) (Description)
Default: null

An optional longer description for this token.

expiry_days
required
integer (Expiry Days)

Number of days until the token expires

name
required
string (Name)

A human-readable name for this token.

Responses

Request samples

Content type
application/json
{
  • "api_scopes": null,
  • "description": null,
  • "expiry_days": 0,
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_devices_by_org

Authorizations:
http
path Parameters
org_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

events

Create, read, and modify entities within Roboto's 'events' domain

create_event

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Array of objects (Associations)
Description (string) or Description (null) (Description)
Default: null
end_time
required
integer (End Time)
object (Metadata)
name
required
string (Name)
start_time
required
integer (Start Time)
tags
Array of strings (Tags)
EventDisplayOptions (object) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "associations": [
    ],
  • "description": null,
  • "end_time": 0,
  • "metadata": { },
  • "name": "string",
  • "start_time": 0,
  • "tags": [
    ],
  • "display_options": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_event_by_id

Authorizations:
http
path Parameters
event_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_event

Authorizations:
http
path Parameters
event_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Description (string) or Description (null) or Description (null) (Description)
MetadataChangeset (object) or Metadata Changeset (null) (Metadata Changeset)
Name (string) or Name (null) (Name)
Start Time (integer) or Start Time (null) (Start Time)
End Time (integer) or End Time (null) (End Time)
EventDisplayOptionsChangeset (object) or Display Options Changeset (null) (Display Options Changeset)

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "metadata_changeset": {
    },
  • "name": "string",
  • "start_time": 0,
  • "end_time": 0,
  • "display_options_changeset": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_event

Authorizations:
http
path Parameters
event_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_event_metadata_keys_for_org

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

query_events_for_associations

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
Array of objects (Associations)
Page Token (string) or Page Token (null) (Page Token)
Default: null

Responses

Request samples

Content type
application/json
{
  • "associations": [
    ],
  • "page_token": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_event_tags_for_org

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

feature-flags

Create, read, and modify entities within Roboto's 'feature-flags' domain

get_all_feature_flags

List every non-deleted feature flag (admin-only).

Triggered when an operator opens the admin feature-flags panel. Soft-deleted flags are excluded; see get_all_deleted_feature_flags for those.

Access control

  • roboto_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

create_feature_flag

Define a new feature flag.

Triggered when a Roboto operator registers a new flag (admin-only). The caller's identity is recorded as the flag's creator and initial modifier.

Access control

  • roboto_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
name
required
string (Name)
Description (string) or Description (null) (Description)
Default: null
rollout_status
string (RolloutStatus)
Default: "NoUsers"
Enum: "NoUsers" "Partial" "AllUsers"

Determines which users see a feature flag as enabled.

  • NoUsers: the flag is off for everyone, regardless of group membership.
  • Partial: the flag is on only for users who belong to at least one of the groups listed in FeatureFlagRecord.rollout_user_group_ids.
  • AllUsers: the flag is on for everyone; rollout_user_group_ids is ignored.
rollout_user_group_ids
Array of strings (Rollout User Group Ids)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": null,
  • "rollout_status": "NoUsers",
  • "rollout_user_group_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

check_all_feature_flags

Evaluate every feature flag for the calling user in their current org.

Triggered on app load by the web UI to populate its flag cache for the signed-in user. Returns {flag_name: enabled} for every non-deleted flag. A flag evaluates to True when its rollout_status is AllUsers, or when it is Partial and the caller belongs to at least one of the flag's associated user groups; NoUsers flags always evaluate to False.

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": { }
}

get_all_deleted_feature_flags

List every soft-deleted feature flag (admin-only).

Triggered when an operator opens the "deleted flags" view in the admin panel to choose one to restore. Live (non-deleted) flags are excluded.

Access control

  • roboto_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_feature_flag

Fetch a single feature flag by its ID (admin-only).

Triggered when an operator drills into a specific flag in the admin panel. Raises if the flag does not exist or has been soft-deleted.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
feature_flag_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_feature_flag

Patch an existing feature flag (admin-only).

Triggered when an operator edits a flag's name, description, rollout status, or replaces its associated user-group set wholesale. Only fields the request explicitly sets are changed; NotSet fields are left alone. When rollout_user_group_ids is provided it fully replaces the existing set (it is not merged with the prior value); for additive/subtractive changes use the /rollout-groups endpoints instead.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
feature_flag_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Name (string) or Name (null) (Name)
Description (string) or Description (null) or Description (null) (Description)
RolloutStatus (string) or Rollout Status (null) (Rollout Status)
Array of Rollout User Group Ids (strings) or Rollout User Group Ids (null) (Rollout User Group Ids)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "rollout_status": "NoUsers",
  • "rollout_user_group_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_feature_flag

Soft-delete a feature flag (admin-only).

Triggered when an operator removes a flag from the admin panel. The row is marked deleted rather than physically removed, so it can be brought back via restore_feature_flag. After this call the flag stops appearing in get_all_feature_flags and check results.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
feature_flag_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

restore_feature_flag

Undo a soft-delete, returning the flag to the live set (admin-only).

Triggered when an operator restores a previously deleted flag from the admin panel. The flag's prior rollout status and user-group associations are preserved. The caller is recorded as the modifier.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
feature_flag_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

list_rollout_groups

Return the user-group IDs currently associated with a flag (admin-only).

Triggered when an operator inspects which groups a flag is scoped to. The list reflects the stored associations regardless of rollout_status; note that the IDs only gate access when rollout_status is Partial.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
feature_flag_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

add_rollout_groups

Associate one or more user groups with a flag's rollout set (admin-only).

Triggered when an operator scopes a flag to additional user groups (e.g. expanding a Partial rollout to a new beta cohort). The provided IDs are unioned with the flag's existing rollout-group set, so re-adding a group that is already associated is a no-op rather than an error. Existing associations are not disturbed. Returns the updated flag record.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
feature_flag_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
user_group_ids
required
Array of strings (User Group Ids)

Responses

Request samples

Content type
application/json
{
  • "user_group_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

remove_rollout_groups

Disassociate one or more user groups from a flag's rollout set (admin-only).

Triggered when an operator narrows a flag's scope by removing groups (e.g. pulling a cohort out of a beta). Removing a group that is not currently associated is a no-op. Returns the updated flag record.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
feature_flag_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
user_group_ids
required
Array of strings (User Group Ids)

Responses

Request samples

Content type
application/json
{
  • "user_group_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

check_feature_flag

Evaluate a single named feature flag for the calling user in their current org.

Triggered when a client wants the state of one specific flag rather than the full set. Returns {"enabled": bool} using the same evaluation rules as check_all_feature_flags: AllUsers is always enabled, Partial is enabled iff the caller is in one of the flag's groups, and NoUsers is always disabled.

An unknown feature_flag_name returns {"enabled": false} rather than 404. This is deliberate: clients reference flags by name in code that may outlive the flag (or land before the flag is created), and the eval path treats a missing definition as "off" so callers do not need to special-case 404. Use the admin GET /feature-flags/id/<id> route when an unknown id should surface as a not-found error instead.

Access control

  • requires_org
Authorizations:
http
path Parameters
feature_flag_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": { }
}

files

Create, read, and modify entities within Roboto's 'files' domain

delete_file

Authorizations:
http
path Parameters
file_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

rename_file

Authorizations:
http
path Parameters
file_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
association_id
required
string (Association Id)
new_path
required
string (New Path)

Responses

Request samples

Content type
application/json
{
  • "association_id": "string",
  • "new_path": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_signed_url

Authorizations:
http
path Parameters
file_id
required
string
query Parameters
string or null
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_all_records_for_association

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
association_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

list_directories

Authorizations:
http
path Parameters
association_id
required
string
query Parameters
string or null
page_size
number
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

create_export_job

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
node_ids
required
Array of strings (Node Ids)

Responses

Request samples

Content type
application/json
{
  • "node_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_export_job

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
export_job_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

set_file_timeline_offsets

Calibrate timelines on a file.

Each entry's unix_epoch_offset_ns is added to stored partition times so they project onto Unix-epoch wall-clock (session_time_ns = stored_time_ns + unix_epoch_offset_ns). Selectors narrow which extents an entry touches:

  1. topic_name restricts the entry to one topic on this file.
  2. timeline_source_name or timeline_source_id restricts the entry to a specific timeline source within the selected scope.
  3. An entry with no selectors targets every timeline extent on the file.

Returns the updated timeline extent records.

All entries apply in a single transaction; if no timeline matches some entry the whole request 404s rather than partially applying. The fetch happens before the AuthZ check so a missing file surfaces as 404, not 403.

Authorizations:
http
path Parameters
fs_node_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
Array of objects (Offsets)

Responses

Request samples

Content type
application/json
{
  • "offsets": [
    ]
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

import_one

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
dataset_id
required
string (Dataset Id)
Description (string) or Description (null) (Description)
Default: null
Device Id (string) or Device Id (null) (Device Id)
Default: null
Array of Tags (strings) or Tags (null) (Tags)
Default: null
Metadata (object) or Metadata (null) (Metadata)
Default: null
relative_path
required
string (Relative Path)
Size (integer) or Size (null) (Size)
Default: null
uri
required
string (Uri)

Responses

Request samples

Content type
application/json
{
  • "dataset_id": "string",
  • "description": null,
  • "device_id": null,
  • "tags": null,
  • "metadata": null,
  • "relative_path": "string",
  • "size": null,
  • "uri": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

import_batch

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
Array of objects (Requests)

Responses

Request samples

Content type
application/json
{
  • "requests": [
    ]
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_file_metadata_keys_for_org

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

query_files

Execute a query against files.

Consistency: Eventually Consistent (for API version >= 2026-03-13)

  • Clients using API version < 2026-03-13: Strongly consistent reads
  • Clients using API version >= 2026-03-13: Eventually consistent reads
  • Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability. Results may not immediately reflect very recent writes. If you've just created or updated files and don't see them in the results, retry after a brief delay.

Access control

  • requires_resource_owner_or_admin
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Condition (object) or ConditionGroup (object) or Condition (null) (Condition)
Default: null
limit
integer (Limit)
Default: 1000
After (string) or After (null) (After)
Default: null
Sort By (string) or Sort By (null) (Sort By)
Default: null
SortDirection (string) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "condition": null,
  • "limit": 1000,
  • "after": null,
  • "sort_by": null,
  • "sort_direction": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_file_query_result_count

Get the count of files matching a query.

Consistency: Eventually Consistent (for API version >= 2026-03-13)

  • Clients using API version < 2026-03-13: Strongly consistent reads
  • Clients using API version >= 2026-03-13: Eventually consistent reads
  • Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability. The count may not immediately reflect very recent writes. If you've just created or updated files and don't see them in the count, retry after a brief delay.

Access control

  • requires_resource_owner_or_admin
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Condition (object) or ConditionGroup (object) or Condition (null) (Condition)
Default: null
limit
integer (Limit)
Default: 1000
After (string) or After (null) (After)
Default: null
Sort By (string) or Sort By (null) (Sort By)
Default: null
SortDirection (string) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "condition": null,
  • "limit": 1000,
  • "after": null,
  • "sort_by": null,
  • "sort_direction": null
}

Response samples

Content type
application/json
{
  • "data": 0
}

get_file_record_by_id

Authorizations:
http
path Parameters
file_id
required
string
query Parameters
number or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_file_record

Authorizations:
http
path Parameters
file_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Description (string) or Description (null) or Description (null) (Description)
Device Id (string) or Device Id (null) or Device Id (null) (Device Id)
MetadataChangeset (object) or Metadata Changeset (null) (Metadata Changeset)
true (boolean) or Ingestion Complete (null) (Ingestion Complete)

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "device_id": "string",
  • "metadata_changeset": {
    },
  • "ingestion_complete": true
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_file_record_by_path

Authorizations:
http
path Parameters
url_quoted_file_path
required
string
association_id
required
string
query Parameters
number or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

begin_signed_url_upload

Begin a single file upload with a pre-signed URL.

Creates a file record in pending state and returns a pre-signed URL that can be used to upload the file content directly.

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
object (Association)

Use to declare an association between two Roboto entities.

file_path
required
string (File Path)
file_size
required
integer (File Size)
Origination (string) or Origination (null) (Origination)
Default: null

Responses

Request samples

Content type
application/json
{
  • "association": {
    },
  • "file_path": "string",
  • "file_size": 0,
  • "origination": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_file_tags_for_org

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

abort_transactions

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
transaction_ids
required
Array of strings (Transaction Ids)

Responses

Request samples

Content type
application/json
{
  • "transaction_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "data": null
}

begin_upload

Begin a batch file upload transaction.

Creates file records in pending state and returns upload mappings that specify where each file should be uploaded.

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
object (Association)

Use to declare an association between two Roboto entities.

origination
required
string (Origination)
required
object (Resource Manifest)
Device Id (string) or Device Id (null) (Device Id)
Default: null

Responses

Request samples

Content type
application/json
{
  • "association": {
    },
  • "origination": "string",
  • "resource_manifest": {
    },
  • "device_id": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

complete_upload

Complete a file upload transaction (batch or single).

Marks all pending files as available and schedules trigger evaluation for dataset associations.

Authorizations:
http
path Parameters
upload_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_upload_credentials

Get temporary credentials for uploading files.

Returns a list of AWS credentials scoped to the upload transaction's storage location(s). Currently returns a single credential for the write bucket, but the list format allows for future multi-bucket upload scenarios.

Authorizations:
http
path Parameters
upload_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

report_upload_progress

Report progress on a batch upload transaction.

Marks the specified files as having completed upload. Returns the list of file IDs that were marked as available.

Authorizations:
http
path Parameters
upload_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
manifest_items
required
Array of strings (Manifest Items)

Responses

Request samples

Content type
application/json
{
  • "manifest_items": [
    ]
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

images

Create, read, and modify entities within Roboto's 'images' domain

get_temporary_container_credentials

Access control

  • requires_org
Authorizations:
http
query Parameters
repository_uri
required
string
permissions
string
Enum: "ReadOnly" "ReadWrite"

Enum for permission levels of a Roboto resource. It is a best practice to only request/use the minimum permissions required for a given operation.

For example:

  • When listing files associated with a dataset or pulling a container image hosted in Roboto's registry, use ReadOnly permissions.
  • When adding files to a dataset or pushing a container image to Roboto's registry, use ReadWrite permissions.
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_container_image

Idempotently delete container image from Roboto's private registry.

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
image_uri
required
string (Image Uri)

Responses

Request samples

Content type
application/json
{
  • "image_uri": "string"
}

Response samples

Content type
application/json
{
  • "error": {
    }
}

put_container_image_record

Admin only.

Memorialize a container image pushed into Roboto's private registry.

:meta private:

Access control

  • roboto_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
object (ContainerImageRecord)

A wire-transmissible representation of a container image.

Responses

Request samples

Content type
application/json
{
  • "record": {
    }
}

Response samples

Content type
application/json
{
  • "data": null
}

delete_container_image_record

Admin only.

Delete our record of container image that has been removed from Roboto's private registry.

:meta private:

Access control

  • roboto_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
image_uri
required
string (Image Uri)

Responses

Request samples

Content type
application/json
{
  • "image_uri": "string"
}

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_container_image_record_deprecated

Retrieve our record of a container image pushed into Roboto's private registry.

Authorizations:
http
path Parameters
org_id
required
string
image_uri
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

list_image_records

Return paginated list of container image URIs pushed into Roboto's registry for a given org.

Access control

  • requires_org
Authorizations:
http
query Parameters
string or null
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

create_image_repository

Idempotently create a container image repository in Roboto's private registry. Repositories are namespaced by org.

Returns: The URI of the created repository.

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
repository_name
required
string (Repository Name)
immutable_image_tags
required
boolean (Immutable Image Tags)

Responses

Request samples

Content type
application/json
{
  • "repository_name": "string",
  • "immutable_image_tags": true
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_image_repository

Delete a container image repository in Roboto's private registry.

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
repository_name
required
string (Repository Name)
force
boolean (Force)
Default: false

Responses

Request samples

Content type
application/json
{
  • "repository_name": "string",
  • "force": false
}

Response samples

Content type
application/json
{
  • "error": {
    }
}

repository_contains_image

Does the given Roboto-managed repository contain an image with the given image tag?

Because Roboto's view of its image registry is eventually consistent, it may be useful to poll this endpoint until it returns True or False to know when an image has been pushed to or deleted from Roboto's registry.

Access control

  • requires_org
Authorizations:
http
path Parameters
repo_name
required
string
image_tag
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

set_image_tag_mutability

Update an existing container image repository in Roboto's private registry to either allow or disallow overwriting of image tags.

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
repository_name
required
string (Repository Name)
immutable_image_tags
required
boolean (Immutable Image Tags)

Responses

Request samples

Content type
application/json
{
  • "repository_name": "string",
  • "immutable_image_tags": true
}

Response samples

Content type
application/json
{
  • "error": {
    }
}

list_repository_records

Return paginated list of repositories within Roboto's registry for a given org.

Access control

  • requires_resource_owner
Authorizations:
http
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

integrations

Create, read, and modify entities within Roboto's 'integrations' domain

list_roboto_regions

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

list_s3_bucket_integrations

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

register_s3_integration

Access control

  • deny_actions
  • deny_devices
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
account_id
required
string (Account Id)
aws_region
required
string (Aws Region)
bucket_name
required
string (Bucket Name)
org_id
required
string (Org Id)
transfer_accelerated
boolean (Transfer Accelerated)
Default: false
readonly
boolean (Readonly)
Default: false

Responses

Request samples

Content type
application/json
{
  • "account_id": "string",
  • "aws_region": "string",
  • "bucket_name": "string",
  • "org_id": "string",
  • "transfer_accelerated": false,
  • "readonly": false
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

layouts

Create, read, and modify entities within Roboto's 'layouts' domain

query_layouts_for_org

Query layouts visible to the caller within their organization.

By default, returns org-wide layouts and the caller's own personal layouts.

Set include_all=true to retrieve every layout in the organization, including other users' personal layouts. This is intended for org-level administration and auditing. Requires the caller to be an org admin; returns 401 Unauthorized otherwise.

Authorizations:
http
query Parameters
string or null
include_all
boolean
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

create_layout

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
accessibility
string (LayoutAccessibility)
Default: "user"
Enum: "organization" "user"

Controls layout accessibility between organization-wide or user-only.

required
object (Layout Definition)

The layout definition as a JSON object.

name
required
string (Name) <= 120 characters

The name of the layout.

schema_version
required
integer (Schema Version)

The schema version associated with the layout definition.

tags
Array of strings (Tags)

The tags associated with the layout.

Responses

Request samples

Content type
application/json
{
  • "accessibility": "organization",
  • "layout_definition": { },
  • "name": "string",
  • "schema_version": 0,
  • "tags": [
    ]
}

Response samples

Content type
application/json
{
  • "data": null
}

get_layout_by_id

Authorizations:
http
path Parameters
layout_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_layout

Update a layout by ID.

Authorization rules:

  • The layout owner can update all fields (name, definition, accessibility, tags, etc.).
  • An org admin who is not the owner can update all fields except name. Attempting to rename another user's layout returns 401 Unauthorized.
  • Any other caller who is not the owner receives 401 Unauthorized.
Authorizations:
http
path Parameters
layout_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
LayoutAccessibility (string) or Accessibility (null) (Accessibility)

Controls layout accessibility between organization-wide or user-only.

Layout Definition (object) or Layout Definition (null) (Layout Definition)

The layout definition as a JSON object.

Name (string) or Name (null) (Name) <= 120 characters

The name of the layout.

Schema Version (integer) or Schema Version (null) (Schema Version)

The schema version associated with the layout definition.

Array of Tags (strings) or Tags (null) (Tags)

The tags associated with the layout.

Responses

Request samples

Content type
application/json
{
  • "accessibility": "organization",
  • "layout_definition": { },
  • "name": "string",
  • "schema_version": 0,
  • "tags": [
    ]
}

Response samples

Content type
application/json
{
  • "data": null
}

delete_layout

Authorizations:
http
path Parameters
layout_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": null
}

get_layout_by_name

Authorizations:
http
path Parameters
layout_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

limits

Create, read, and modify entities within Roboto's 'limits' domain

get_limits_for_org

Authorizations:
http
path Parameters
org_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

mcp

Create, read, and modify entities within Roboto's 'mcp' domain

admin_list_mcp_servers

Admin-only: List all registered MCP servers with org_ids populated.

Access control

  • roboto_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

admin_register_mcp_server

Admin-only: Register an MCP server with optional org scoping.

Supports both DCR and manual registration modes. Set org_ids to scope the server to specific orgs, or leave empty for global visibility.

Access control

  • roboto_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
registration_mode
string (RegistrationMode)
Default: "manual"
Enum: "dcr" "manual"
server_url
required
string (Server Url)
display_name
required
string (Display Name) <= 32 characters ^[a-zA-Z0-9_-]+$
Oauth Issuer Url (string) or Oauth Issuer Url (null) (Oauth Issuer Url)
Default: null
Authorization Endpoint (string) or Authorization Endpoint (null) (Authorization Endpoint)
Default: null
Token Endpoint (string) or Token Endpoint (null) (Token Endpoint)
Default: null
Client Id (string) or Client Id (null) (Client Id)
Default: null
Client Secret (string) or Client Secret (null) (Client Secret)
Default: null
scopes
Array of strings (Scopes)
Revocation Endpoint (string) or Revocation Endpoint (null) (Revocation Endpoint)
Default: null
org_ids
Array of strings (Org Ids)
object (Extra Auth Params)
Allowed Tools (object) or Allowed Tools (null) (Allowed Tools)
Default: null

Responses

Request samples

Content type
application/json
{
  • "registration_mode": "dcr",
  • "server_url": "string",
  • "display_name": "string",
  • "oauth_issuer_url": null,
  • "authorization_endpoint": null,
  • "token_endpoint": null,
  • "client_id": null,
  • "client_secret": null,
  • "scopes": [
    ],
  • "revocation_endpoint": null,
  • "org_ids": [
    ],
  • "extra_auth_params": {
    },
  • "allowed_tools": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

admin_delete_mcp_server

Admin-only: Delete an MCP server registration. Cascades to all user tokens.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
server_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

admin_update_allowed_tools

Admin-only: Set or clear the tool allowlist for an MCP server.

Keys are tool names, values are enabled (true) or blocked (false). Set allowed_tools to null to clear and revert to auto-populate on next discovery.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
server_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Allowed Tools (object) or Allowed Tools (null) (Allowed Tools)
Default: null

Responses

Request samples

Content type
application/json
{
  • "allowed_tools": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

admin_copy_allowed_tools

Admin-only: Copy the tool allowlist from another MCP server.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
server_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
source_server_id
required
string (Source Server Id)

Responses

Request samples

Content type
application/json
{
  • "source_server_id": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

admin_discover_tools

Admin-only: Discover available tools from an MCP server.

Uses the calling admin's OAuth token for the server. The admin must have connected to this server (via OAuth) first. Pass org_id as a query parameter to specify which org context to use for the token.

Returns a list of tool dicts with name, description, inputSchema, and readOnlyHint annotation for each tool.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
server_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

admin_update_mcp_server_orgs

Admin-only: Update the org scoping for an MCP server.

Replaces the current org list. Tokens for removed orgs are cascade-deleted. An empty org_ids list makes the server global.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
server_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
org_ids
Array of strings (Org Ids)

Responses

Request samples

Content type
application/json
{
  • "org_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

oauth_callback

Exchange an authorization code for tokens.

The server_id and org_id are recovered from the state token stored in the database, so this endpoint doesn't need them in the URL — important because OAuth providers (e.g., GitHub) only redirect with code + state.

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
code
required
string (Code)
state
required
string (State)

Responses

Request samples

Content type
application/json
{
  • "code": "string",
  • "state": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

list_mcp_servers

List MCP servers visible to the caller's org (global + org-scoped).

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

register_mcp_server

Register a new MCP server or return existing if URL matches for the caller's org.

Access control

  • org_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
registration_mode
string (RegistrationMode)
Default: "dcr"
Enum: "dcr" "manual"
server_url
required
string (Server Url)
display_name
required
string (Display Name) <= 32 characters ^[a-zA-Z0-9_-]+$
Oauth Issuer Url (string) or Oauth Issuer Url (null) (Oauth Issuer Url)
Default: null
Authorization Endpoint (string) or Authorization Endpoint (null) (Authorization Endpoint)
Default: null
Token Endpoint (string) or Token Endpoint (null) (Token Endpoint)
Default: null
Client Id (string) or Client Id (null) (Client Id)
Default: null
Client Secret (string) or Client Secret (null) (Client Secret)
Default: null
Revocation Endpoint (string) or Revocation Endpoint (null) (Revocation Endpoint)
Default: null
scopes
Array of strings (Scopes)
object (Extra Auth Params)
Allowed Tools (object) or Allowed Tools (null) (Allowed Tools)
Default: null

Responses

Request samples

Content type
application/json
{
  • "registration_mode": "dcr",
  • "server_url": "string",
  • "display_name": "string",
  • "oauth_issuer_url": null,
  • "authorization_endpoint": null,
  • "token_endpoint": null,
  • "client_id": null,
  • "client_secret": null,
  • "revocation_endpoint": null,
  • "scopes": [
    ],
  • "extra_auth_params": {
    },
  • "allowed_tools": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_mcp_server

Get details of a specific MCP server.

Access control

  • requires_org
Authorizations:
http
path Parameters
server_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_mcp_server

Remove the caller's org from an MCP server, deleting it entirely if this was the only org.

Access control

  • org_admin_only
Authorizations:
http
path Parameters
server_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_mcp_server_context

Get per-org context for an MCP server.

Access control

  • requires_org
Authorizations:
http
path Parameters
server_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

set_mcp_server_context

Set per-org context for an MCP server. This text is injected into the AI system prompt.

Access control

  • org_admin_only
Authorizations:
http
path Parameters
server_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
context
string (Context) <= 4000 characters
Default: ""

Responses

Request samples

Content type
application/json
{
  • "context": ""
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

start_oauth_flow

Start an OAuth2 authorization flow for the current user and org.

Access control

  • requires_org
Authorizations:
http
path Parameters
server_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

disconnect_mcp_server

Revoke and delete the current user's token for this server in the current org.

Access control

  • requires_org
Authorizations:
http
path Parameters
server_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

list_mcp_token_statuses

List token statuses for the current user in their org.

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

notifications

Create, read, and modify entities within Roboto's 'notifications' domain

get_notifications_for_user

Access control

  • requires_org
Authorizations:
http
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
One of
string
Enum: "unread" "read"

Notification read status enum

Responses

Request samples

Content type
application/json
null

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_notification

Access control

  • requires_org
Authorizations:
http
path Parameters
notification_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
notification_id
required
string (Notification Id)
ReadStatus (string) or null
Default: null
Lifecycle Status (object) or Lifecycle Status (null) (Lifecycle Status)
Default: null

Responses

Request samples

Content type
application/json
{
  • "notification_id": "string",
  • "read_status": null,
  • "lifecycle_status": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_notification

Access control

  • requires_org
Authorizations:
http
path Parameters
notification_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

put_notification_records

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
Array of objects (Requests)

Responses

Request samples

Content type
application/json
{
  • "requests": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

orgs

Create, read, and modify entities within Roboto's 'orgs' domain

get_orgs_by_caller

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

update_org_user

Access control

  • org_admin_only
Authorizations:
http
path Parameters
org_id
required
string
url_encoded_user_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Array of Add Roles (strings) or Add Roles (null) (Add Roles)
Default: null
Array of Remove Roles (strings) or Remove Roles (null) (Remove Roles)
Default: null

Responses

Request samples

Content type
application/json
{
  • "add_roles": null,
  • "remove_roles": null
}

Response samples

Content type
application/json
{
  • "data": null
}

query

Create, read, and modify entities within Roboto's 'query' domain

convert_natural_language_to_roboql

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
prompt
required
string (Prompt)

Responses

Request samples

Content type
application/json
{
  • "prompt": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_query_record

Authorizations:
http
path Parameters
query_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_query_result_count

Get the total number of results for a query.

Consistency: Eventually Consistent (for API version >= 2026-03-13)

  • Clients using API version < 2026-03-13: Strongly consistent reads
  • Clients using API version >= 2026-03-13: Eventually consistent reads
  • Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability. The count may not immediately reflect very recent writes. If you've just created or updated data and don't see it in the count, retry after a brief delay.

Authorizations:
http
path Parameters
query_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": 0
}

get_query_results

Get paginated results for a query.

Consistency: Eventually Consistent (for API version >= 2026-03-13)

  • Clients using API version < 2026-03-13: Strongly consistent reads
  • Clients using API version >= 2026-03-13: Eventually consistent reads
  • Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability. Results may not immediately reflect very recent writes. If you've just created or updated data and don't see it in the results, retry after a brief delay.

Authorizations:
http
path Parameters
query_id
required
string
query Parameters
string or null
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_recent_queries

Authorizations:
http
query Parameters
required
string or null
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": null
}

submit_roboql_query

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
content_mode
string (QueryContentMode)
Default: "record_with_meta"
Enum: "record_only" "record_with_meta"

The content mode for query results.

required
Query (string) or Query (null) (Query)

The conditions, sorting behavior, and limit of this query.

target
required
string (QueryTarget)
Enum: "collections" "datasets" "files" "topics" "topic_message_paths" "events"

The type of data being requested, e.g. 'Datasets' or 'Topics'.

Responses

Request samples

Content type
application/json
{
  • "content_mode": "record_only",
  • "query": "string",
  • "target": "collections"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

submit_structured_query

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
content_mode
string (QueryContentMode)
Default: "record_with_meta"
Enum: "record_only" "record_with_meta"

The content mode for query results.

required
object (QuerySpecification)

The conditions, sorting behavior, and limit of this query.

target
required
string (QueryTarget)
Enum: "collections" "datasets" "files" "topics" "topic_message_paths" "events"

The type of data being requested, e.g. 'Datasets' or 'Topics'.

Responses

Request samples

Content type
application/json
{
  • "content_mode": "record_only",
  • "query": {
    },
  • "target": "collections"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

submit_term_query

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
content_mode
string (QueryContentMode)
Default: "record_with_meta"
Enum: "record_only" "record_with_meta"

The content mode for query results.

term
string (Term)
Default: ""

A string search term which this query will attempt to match across any appropriate fields.

target
required
string (QueryTarget)
Enum: "collections" "datasets" "files" "topics" "topic_message_paths" "events"

The type of data being requested, e.g. 'Datasets' or 'Topics'.

Responses

Request samples

Content type
application/json
{
  • "content_mode": "record_only",
  • "term": "",
  • "target": "collections"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

secrets

Create, read, and modify entities within Roboto's 'secrets' domain

get_secrets_for_org

Access control

  • requires_resource_owner
Authorizations:
http
query Parameters
string or null
number or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

create_secret

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
name
required
string (Name)

Responses

Request samples

Content type
application/json
{
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_secret_by_name

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
secret_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_secret_record

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
secret_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_secret_by_name

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
secret_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_secret_creds

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
secret_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

sessions

A Session is an operational time window of a Device, such as a drone flight, a vehicle drive, or a robot arm test run.

list_sessions

Access control

  • requires_org
Authorizations:
http
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

create_session

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Name (string) or Name (null) (Name)
Default: null
device_ids
Array of strings (Device Ids)

Responses

Request samples

Content type
application/json
{
  • "name": null,
  • "device_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_session

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
session_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_session

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
session_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Name (string) or Name (null) or Name (null) (Name)

Responses

Request samples

Content type
application/json
{
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_session

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
session_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

list_session_devices

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
session_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

attach_to_device

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
session_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
device_id
required
string (Device Id)

Responses

Request samples

Content type
application/json
{
  • "device_id": "string"
}

Response samples

Content type
application/json
{
  • "data": null
}

detach_from_device

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
session_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
device_id
required
string (Device Id)

Responses

Request samples

Content type
application/json
{
  • "device_id": "string"
}

Response samples

Content type
application/json
{
  • "error": {
    }
}

list_session_files

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
session_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

add_files

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
session_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
Array of objects (Files)

Responses

Request samples

Content type
application/json
{
  • "files": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

remove_files

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
session_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
file_ids
required
Array of strings (File Ids)

Responses

Request samples

Content type
application/json
{
  • "file_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

list_session_topics

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
session_id
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

tokens

Create, read, and modify entities within Roboto's 'tokens' domain

list_tokens

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

create_token

Access control

  • deny_actions
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Array of Api Scopes (strings) or Api Scopes (null) (Api Scopes)
Default: null

Optional set of API scopes to grant this token.

Description (string) or Description (null) (Description)
Default: null

An optional longer description for this token.

expiry_days
required
integer (Expiry Days)

Number of days until the token expires

name
required
string (Name)

A human-readable name for this token.

Responses

Request samples

Content type
application/json
{
  • "api_scopes": null,
  • "description": null,
  • "expiry_days": 0,
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

deprecated_get_token

Authorizations:
http
path Parameters
token_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

deprecated_delete_token

Authorizations:
http
path Parameters
token_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_token

Authorizations:
http
path Parameters
token_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_token

Authorizations:
http
path Parameters
token_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

disable_token

Authorizations:
http
path Parameters
token_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

enable_token

Authorizations:
http
path Parameters
token_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

topics

Create, read, and modify entities within Roboto's 'topics' domain

create_topic

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
object (Association)

Use to declare an association between two Roboto entities.

topic_name
required
string (Topic Name)
End Time (integer) or End Time (null) (End Time)
Default: null
Message Count (integer) or Message Count (null) (Message Count)
Default: null
Metadata (object) or Metadata (null) (Metadata)
Default: null
Schema Checksum (string) or Schema Checksum (null) (Schema Checksum)
Default: null
Schema Name (string) or Schema Name (null) (Schema Name)
Default: null
Start Time (integer) or Start Time (null) (Start Time)
Default: null
Array of Message Paths (objects) or Message Paths (null) (Message Paths)
Default: null

Responses

Request samples

Content type
application/json
{
  • "association": {
    },
  • "topic_name": "string",
  • "end_time": null,
  • "message_count": null,
  • "metadata": null,
  • "schema_checksum": null,
  • "schema_name": null,
  • "start_time": null,
  • "message_paths": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_topics_by_association

Authorizations:
http
path Parameters
encoded_association
required
string
query Parameters
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_topic_by_name_and_association

Authorizations:
http
path Parameters
encoded_association
required
string
url_quoted_topic_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_topic

Authorizations:
http
path Parameters
encoded_association
required
string
url_quoted_topic_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

add_topic_message_path

Authorizations:
http
path Parameters
encoded_association
required
string
url_quoted_topic_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
message_path
required
string (Message Path)
data_type
required
string (Data Type)
canonical_data_type
required
string (CanonicalDataType)
Enum: "array" "boolean" "byte" "categorical" "image" "number" "number_array" "object" "string" "timestamp" "unknown" "latdegfloat" "londegfloat" "latdegint" "londegint"

Normalized data types used across different robotics frameworks.

Well-known and simplified data types that provide a common vocabulary for describing message path data types across different frameworks and technologies. These canonical types are primarily used for UI rendering decisions and cross-platform compatibility.

The canonical types abstract away framework-specific details while preserving the essential characteristics needed for data processing and visualization.

References: - ROS 1 field types: http://wiki.ros.org/msg - ROS 2 field types: https://docs.ros.org/en/iron/Concepts/Basic/About-Interfaces.html#field-types - uORB: https://docs.px4.io/main/en/middleware/uorb.html#adding-a-new-topic

Example mappings: - float32 -> CanonicalDataType.Number - uint8[] -> CanonicalDataType.Array - sensor_msgs/Image -> CanonicalDataType.Image - geometry_msgs/Pose -> CanonicalDataType.Object - std_msgs/Header -> CanonicalDataType.Object - string -> CanonicalDataType.String - char -> CanonicalDataType.String - bool -> CanonicalDataType.Boolean - byte -> CanonicalDataType.Byte

object (Metadata)

Initial key-value pairs to associate with this topic message path for discovery and search, e.g. { 'min': 0.71, 'max': 1.77, 'classification': 'my-custom-classification-tag' }

path_in_schema
required
Array of strings (Path In Schema)

List of path components representing the field's location in the source data schema. For nested fields like 'position.x', this would be ['position', 'x'].

Responses

Request samples

Content type
application/json
{
  • "message_path": "string",
  • "data_type": "string",
  • "canonical_data_type": "array",
  • "metadata": { },
  • "path_in_schema": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_topic_message_path

Authorizations:
http
path Parameters
encoded_association
required
string
url_quoted_topic_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
message_path
required
string (Message Path)
TaglessMetadataChangeset (object) or Metadata Changeset (null) (Metadata Changeset)
Data Type (string) or Data Type (null) (Data Type)
CanonicalDataType (string) or Canonical Data Type (null) (Canonical Data Type)
Array of Path In Schema (strings) or Path In Schema (null) (Path In Schema)

Responses

Request samples

Content type
application/json
{
  • "message_path": "string",
  • "metadata_changeset": {
    },
  • "data_type": "string",
  • "canonical_data_type": "array",
  • "path_in_schema": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

add_message_path_representation

Authorizations:
http
path Parameters
encoded_association
required
string
url_quoted_topic_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
object (Association)

Use to declare an association between two Roboto entities.

storage_format
required
string (RepresentationStorageFormat)
Enum: "mcap" "parquet"

Supported storage formats for topic data representations.

Defines the available formats for storing and accessing topic data within the Roboto platform. Each format has different characteristics and use cases.

version
required
integer (Version)
Format (string) or Format (null) (Format)
Default: null
Array of Transformations (strings) or Transformations (null) (Transformations)
Default: null
message_path_id
required
string (Message Path Id)

Responses

Request samples

Content type
application/json
{
  • "association": {
    },
  • "storage_format": "mcap",
  • "version": 0,
  • "format": null,
  • "transformations": null,
  • "message_path_id": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

set_default_topic_representation

Authorizations:
http
path Parameters
encoded_association
required
string
url_quoted_topic_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
object (Association)

Use to declare an association between two Roboto entities.

storage_format
required
string (RepresentationStorageFormat)
Enum: "mcap" "parquet"

Supported storage formats for topic data representations.

Defines the available formats for storing and accessing topic data within the Roboto platform. Each format has different characteristics and use cases.

version
required
integer (Version)
Format (string) or Format (null) (Format)
Default: null
Array of Transformations (strings) or Transformations (null) (Transformations)
Default: null

Responses

Request samples

Content type
application/json
{
  • "association": {
    },
  • "storage_format": "mcap",
  • "version": 0,
  • "format": null,
  • "transformations": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_all_topics_for_association

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
association_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_topic_by_id

Authorizations:
http
path Parameters
topic_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_topic

Authorizations:
http
path Parameters
topic_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
End Time (integer) or End Time (null) or End Time (null) (End Time)
Message Count (integer) or Message Count (null) (Message Count)
Schema Checksum (string) or Schema Checksum (null) or Schema Checksum (null) (Schema Checksum)
Schema Name (string) or Schema Name (null) or Schema Name (null) (Schema Name)
Start Time (integer) or Start Time (null) or Start Time (null) (Start Time)
MetadataChangeset (object) or Metadata Changeset (null) (Metadata Changeset)
MessagePathChangeset (object) or Message Path Changeset (null) (Message Path Changeset)

Responses

Request samples

Content type
application/json
{
  • "end_time": 0,
  • "message_count": 0,
  • "schema_checksum": "string",
  • "schema_name": "string",
  • "start_time": 0,
  • "metadata_changeset": {
    },
  • "message_path_changeset": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_topic_by_id

Authorizations:
http
path Parameters
topic_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

add_topic_message_path_by_id

Authorizations:
http
path Parameters
topic_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
message_path
required
string (Message Path)
data_type
required
string (Data Type)
canonical_data_type
required
string (CanonicalDataType)
Enum: "array" "boolean" "byte" "categorical" "image" "number" "number_array" "object" "string" "timestamp" "unknown" "latdegfloat" "londegfloat" "latdegint" "londegint"

Normalized data types used across different robotics frameworks.

Well-known and simplified data types that provide a common vocabulary for describing message path data types across different frameworks and technologies. These canonical types are primarily used for UI rendering decisions and cross-platform compatibility.

The canonical types abstract away framework-specific details while preserving the essential characteristics needed for data processing and visualization.

References: - ROS 1 field types: http://wiki.ros.org/msg - ROS 2 field types: https://docs.ros.org/en/iron/Concepts/Basic/About-Interfaces.html#field-types - uORB: https://docs.px4.io/main/en/middleware/uorb.html#adding-a-new-topic

Example mappings: - float32 -> CanonicalDataType.Number - uint8[] -> CanonicalDataType.Array - sensor_msgs/Image -> CanonicalDataType.Image - geometry_msgs/Pose -> CanonicalDataType.Object - std_msgs/Header -> CanonicalDataType.Object - string -> CanonicalDataType.String - char -> CanonicalDataType.String - bool -> CanonicalDataType.Boolean - byte -> CanonicalDataType.Byte

object (Metadata)

Initial key-value pairs to associate with this topic message path for discovery and search, e.g. { 'min': 0.71, 'max': 1.77, 'classification': 'my-custom-classification-tag' }

path_in_schema
required
Array of strings (Path In Schema)

List of path components representing the field's location in the source data schema. For nested fields like 'position.x', this would be ['position', 'x'].

Responses

Request samples

Content type
application/json
{
  • "message_path": "string",
  • "data_type": "string",
  • "canonical_data_type": "array",
  • "metadata": { },
  • "path_in_schema": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_topic_message_path_by_id

Authorizations:
http
path Parameters
topic_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
message_path
required
string (Message Path)
TaglessMetadataChangeset (object) or Metadata Changeset (null) (Metadata Changeset)
Data Type (string) or Data Type (null) (Data Type)
CanonicalDataType (string) or Canonical Data Type (null) (Canonical Data Type)
Array of Path In Schema (strings) or Path In Schema (null) (Path In Schema)

Responses

Request samples

Content type
application/json
{
  • "message_path": "string",
  • "metadata_changeset": {
    },
  • "data_type": "string",
  • "canonical_data_type": "array",
  • "path_in_schema": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

add_message_path_representation_by_id

Authorizations:
http
path Parameters
topic_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
object (Association)

Use to declare an association between two Roboto entities.

storage_format
required
string (RepresentationStorageFormat)
Enum: "mcap" "parquet"

Supported storage formats for topic data representations.

Defines the available formats for storing and accessing topic data within the Roboto platform. Each format has different characteristics and use cases.

version
required
integer (Version)
Format (string) or Format (null) (Format)
Default: null
Array of Transformations (strings) or Transformations (null) (Transformations)
Default: null
message_path_id
required
string (Message Path Id)

Responses

Request samples

Content type
application/json
{
  • "association": {
    },
  • "storage_format": "mcap",
  • "version": 0,
  • "format": null,
  • "transformations": null,
  • "message_path_id": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_message_path_representations

Authorizations:
http
path Parameters
topic_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_message_path_representations_by_format

Authorizations:
http
path Parameters
topic_id
required
string
storage_format
required
string
Enum: "mcap" "parquet"

Supported storage formats for topic data representations.

Defines the available formats for storing and accessing topic data within the Roboto platform. Each format has different characteristics and use cases.

header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

set_default_topic_representation_by_id

Authorizations:
http
path Parameters
topic_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
object (Association)

Use to declare an association between two Roboto entities.

storage_format
required
string (RepresentationStorageFormat)
Enum: "mcap" "parquet"

Supported storage formats for topic data representations.

Defines the available formats for storing and accessing topic data within the Roboto platform. Each format has different characteristics and use cases.

version
required
integer (Version)
Format (string) or Format (null) (Format)
Default: null
Array of Transformations (strings) or Transformations (null) (Transformations)
Default: null

Responses

Request samples

Content type
application/json
{
  • "association": {
    },
  • "storage_format": "mcap",
  • "version": 0,
  • "format": null,
  • "transformations": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_topic_schema

Return the schema of a topic, or 404 if it has no schema set.

The caller must have view access to the resource the topic belongs to.

Authorizations:
http
path Parameters
topic_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

set_topic_timeline_offsets

Shift the timestamps a topic's data is reported under.

Each entry in request.offsets carries a unix_epoch_offset_ns value plus optional selectors (timeline source id / source name); the offset is written to every timeline extent on this topic that matches the selectors. Sessions then report stored_time_ns + unix_epoch_offset_ns for samples drawn from those extents.

Contract:

  1. The URL pins the call to one topic, so entries must not set topic_name (400 otherwise; that selector is only meaningful on the file-scoped variant where one request can target many topics).
  2. The whole batch is applied in one transaction — either every matched extent is updated or none are.
  3. If no entry's selectors match any extent on this topic, the request is rejected with 404 so the caller can distinguish "matched nothing" from "shifted nothing."

The caller must have edit access to the file or dataset the topic belongs to.

Authorizations:
http
path Parameters
topic_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
Array of objects (Offsets)

Responses

Request samples

Content type
application/json
{
  • "offsets": [
    ]
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_message_path_by_id

Authorizations:
http
path Parameters
message_path_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_topic_metadata_keys_for_org

Get unique metadata keys from topics across all topics in the organization.

Backward compatibility behavior:

  • Pre-v2026_03_13 clients: Uses strongly consistent reads
  • v2026_03_13+ clients: Uses eventually consistent reads
  • Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability. Results may not immediately reflect very recent writes. If you've just created or updated topic metadata and don't see it in the results, retry after a brief delay.

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

list_timeline_extents

List the timeline extents for a topic partition.

A topic partition is one file's contribution to a topic; an extent is the (min_ns, max_ns) range that partition covers under one timeline source. The caller must have view access to the file the partition belongs to.

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
topic_part_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_schema_by_id

Look up a topic schema by ID.

Schemas are scoped to an org; the caller must hold org-wide view access in the org that owns the schema.

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
schema_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_schema_fields

List the fields declared by a topic schema.

The caller must hold org-wide view access in the org that owns the schema.

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
schema_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

list_timeline_sources

List every timeline source registered for a schema.

The caller must hold org-wide view access in the org that owns the schema.

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
schema_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

update_timeline_source

Rename a timeline source, or change which source is the schema's default.

Only the fields explicitly set on the request are changed. The caller must hold org-wide edit access in the org that owns the schema.

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
schema_id
required
string
timeline_source_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Is Default (boolean) or Is Default (null) (Is Default)
Name (string) or Name (null) (Name)

Responses

Request samples

Content type
application/json
{
  • "is_default": true,
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_timeline_source

Remove a timeline source from a schema.

Also drops every timeline extent measured against the source and refreshes the aggregate timestamps of any session that cited those extents. Runs synchronously, so this can be slow when the source is widely used. The caller must hold org-wide edit access in the org that owns the schema.

Access control

  • requires_resource_owner
Authorizations:
http
path Parameters
schema_id
required
string
timeline_source_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_all_unique_topic_message_path_metadata_keys_for_org

Get unique metadata keys from message paths across all topics in the organization.

Consistency: Eventually Consistent (for API version >= 2026-03-13)

  • Clients using API version < 2026-03-13: Strongly consistent reads
  • Clients using API version >= 2026-03-13: Eventually consistent reads
  • Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability. Results may not immediately reflect very recent writes. If you've just created or updated message path metadata and don't see it in the results, retry after a brief delay.

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_all_unique_topic_message_paths_for_org

Get unique message paths across all topics in the organization.

Consistency: Eventually Consistent (for API version >= 2026-03-13)

  • Clients using API version < 2026-03-13: Strongly consistent reads
  • Clients using API version >= 2026-03-13: Eventually consistent reads
  • Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability. Results may not immediately reflect very recent writes. If you've just created message paths and don't see them in the results, retry after a brief delay.

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_unique_topic_names_for_org

Get unique topic names across all topics in the organization.

Consistency: Eventually Consistent (for API version >= 2026-03-13)

  • Clients using API version < 2026-03-13: Strongly consistent reads
  • Clients using API version >= 2026-03-13: Eventually consistent reads
  • Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability. Results may not immediately reflect very recent writes. If you've just created topics and don't see them in the results, retry after a brief delay.

Access control

  • requires_resource_owner
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

triggers

Create, read, and modify entities within Roboto's 'triggers' domain

create_trigger

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Action Digest (string) or Action Digest (null) (Action Digest)
Default: null
action_name
required
string (Action Name)
Action Owner Id (string) or Action Owner Id (null) (Action Owner Id)
Default: null
Array of Additional Inputs (strings) or Additional Inputs (null) (Additional Inputs)
Default: null
Array of Causes (strings) or Causes (null) (Causes)
Default: null
ComputeRequirements (object) or null
Default: null
Condition (object) or ConditionGroup (object) or Condition (null) (Condition)
Default: null
ContainerParameters (object) or null
Default: null
enabled
boolean (Enabled)
Default: true
for_each
required
string (TriggerForEachPrimitive)
Enum: "dataset" "dataset_file"

Defines the granularity at which a trigger executes.

Determines whether the trigger creates one invocation per dataset or one invocation per file within datasets that match the trigger conditions.

name
required
string (Name) <= 256 characters [\w\-]+
Parameter Values (object) or Parameter Values (null) (Parameter Values)
Default: null
required_inputs
required
Array of strings (Required Inputs)
Service User Id (string) or Service User Id (null) (Service User Id)
Default: null
Timeout (integer) or Timeout (null) (Timeout)
Default: null

Responses

Request samples

Content type
application/json
{
  • "action_digest": null,
  • "action_name": "string",
  • "action_owner_id": null,
  • "additional_inputs": null,
  • "causes": null,
  • "compute_requirement_overrides": null,
  • "condition": null,
  • "container_parameter_overrides": null,
  • "enabled": true,
  • "for_each": "dataset",
  • "name": "string",
  • "parameter_values": null,
  • "required_inputs": [
    ],
  • "service_user_id": null,
  • "timeout": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_trigger_by_name

Access control

  • requires_resource_owner_member
Authorizations:
http
path Parameters
trigger_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_trigger

Access control

  • requires_resource_owner_member
Authorizations:
http
path Parameters
trigger_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Action Name (string) or Action Name (null) (Action Name)
Action Owner Id (string) or Action Owner Id (null) (Action Owner Id)
Action Digest (string) or Action Digest (null) or Action Digest (null) (Action Digest)
Array of Additional Inputs (strings) or Additional Inputs (null) or Additional Inputs (null) (Additional Inputs)
Array of Causes (strings) or Causes (null) (Causes)
ComputeRequirements (object) or Compute Requirement Overrides (null) or Compute Requirement Overrides (null) (Compute Requirement Overrides)
ContainerParameters (object) or Container Parameter Overrides (null) or Container Parameter Overrides (null) (Container Parameter Overrides)
Condition (object) or ConditionGroup (object) or Condition (null) or Condition (null) (Condition)
Enabled (boolean) or Enabled (null) (Enabled)
TriggerForEachPrimitive (string) or For Each (null) (For Each)
Parameter Values (object) or Parameter Values (null) or Parameter Values (null) (Parameter Values)
Array of Required Inputs (strings) or Required Inputs (null) (Required Inputs)
Timeout (integer) or Timeout (null) or Timeout (null) (Timeout)

Responses

Request samples

Content type
application/json
{
  • "action_name": "string",
  • "action_owner_id": "string",
  • "action_digest": "string",
  • "additional_inputs": [
    ],
  • "causes": [
    ],
  • "compute_requirement_overrides": {
    },
  • "container_parameter_overrides": {
    },
  • "condition": {
    },
  • "enabled": true,
  • "for_each": "dataset",
  • "parameter_values": { },
  • "required_inputs": [
    ],
  • "timeout": 0
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_trigger

Access control

  • requires_resource_owner_member
Authorizations:
http
path Parameters
trigger_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_trigger_evaluations

Access control

  • requires_resource_owner_member
Authorizations:
http
path Parameters
trigger_name
required
string
query Parameters
limit
number
string or null
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

query_aggregated_triggers

Access control

  • requires_resource_owner_member
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Condition (object) or ConditionGroup (object) or Condition (null) (Condition)
Default: null
limit
integer (Limit)
Default: 1000
After (string) or After (null) (After)
Default: null
Sort By (string) or Sort By (null) (Sort By)
Default: null
SortDirection (string) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "condition": null,
  • "limit": 1000,
  • "after": null,
  • "sort_by": null,
  • "sort_direction": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_dataset_trigger_evaluations

Access control

  • requires_resource_owner_member
Authorizations:
http
path Parameters
dataset_id
required
string
query Parameters
limit
number
string or null
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_dataset_trigger_evaluations_summary

Access control

  • requires_resource_owner_member
Authorizations:
http
path Parameters
dataset_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_trigger_by_id

Authorizations:
http
path Parameters
trigger_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_trigger_evaluations_count

Authorizations:
http
path Parameters
trigger_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": 0
}

query_triggers

Access control

  • requires_resource_owner_member
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Condition (object) or ConditionGroup (object) or Condition (null) (Condition)
Default: null
limit
integer (Limit)
Default: 1000
After (string) or After (null) (After)
Default: null
Sort By (string) or Sort By (null) (Sort By)
Default: null
SortDirection (string) or null
Default: null

Responses

Request samples

Content type
application/json
{
  • "condition": null,
  • "limit": 1000,
  • "after": null,
  • "sort_by": null,
  • "sort_direction": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

create_scheduled_trigger

Access control

  • requires_org
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
action_name
required
string (Action Name) [\w\-]+
Action Owner Id (string) or Action Owner Id (null) (Action Owner Id)
Default: null
ComputeRequirements (object) or null
Default: null
ContainerParameters (object) or null
Default: null
enabled
required
boolean (Enabled)
InvocationInput (object) or null
Default: null
InvocationUploadDestination (object) or null
Default: null
name
required
string (Name) <= 256 characters [\w\-]+
Parameter Values (object) or Parameter Values (null) (Parameter Values)
Default: null
schedule
required
string (Schedule)
Timeout (integer) or Timeout (null) (Timeout)
Default: null

Responses

Request samples

Content type
application/json
{
  • "action_name": "string",
  • "action_owner_id": null,
  • "compute_requirement_overrides": null,
  • "container_parameter_overrides": null,
  • "enabled": true,
  • "invocation_input": null,
  • "invocation_upload_destination": null,
  • "name": "string",
  • "parameter_values": null,
  • "schedule": "string",
  • "timeout": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_scheduled_trigger_by_name

Access control

  • requires_resource_owner_member
Authorizations:
http
path Parameters
trigger_name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_scheduled_trigger_by_id

Authorizations:
http
path Parameters
trigger_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_scheduled_trigger

Authorizations:
http
path Parameters
trigger_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Action Name (string) or Action Name (null) (Action Name)
Action Owner Id (string) or Action Owner Id (null) (Action Owner Id)
ComputeRequirements (object) or Compute Requirement Overrides (null) or Compute Requirement Overrides (null) (Compute Requirement Overrides)
ContainerParameters (object) or Container Parameter Overrides (null) or Container Parameter Overrides (null) (Container Parameter Overrides)
Enabled (boolean) or Enabled (null) (Enabled)
InvocationInput (object) or Invocation Input (null) or Invocation Input (null) (Invocation Input)
InvocationUploadDestination (object) or Invocation Upload Destination (null) or Invocation Upload Destination (null) (Invocation Upload Destination)
Parameter Values (object) or Parameter Values (null) or Parameter Values (null) (Parameter Values)
Schedule (string) or Schedule (null) (Schedule)
Timeout (integer) or Timeout (null) or Timeout (null) (Timeout)

Responses

Request samples

Content type
application/json
{
  • "action_name": "string",
  • "action_owner_id": "string",
  • "compute_requirement_overrides": {
    },
  • "container_parameter_overrides": {
    },
  • "enabled": true,
  • "invocation_input": {
    },
  • "invocation_upload_destination": {
    },
  • "parameter_values": { },
  • "schedule": "string",
  • "timeout": 0
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_scheduled_trigger

Authorizations:
http
path Parameters
trigger_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

user-groups

Create, read, and modify entities within Roboto's 'user-groups' domain

get_all_user_groups

List every user group in the system.

Triggered when an admin opens the user-groups admin panel, or when the feature-flags admin panel needs the full set of groups so an operator can pick which ones a flag should be associated with. Returns every record unfiltered and unpaginated — the expected cardinality is small (tens).

Access control

  • roboto_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

create_user_group

Create a user group (a named, admin-managed set of user ids used to gate features).

Triggered when a Roboto admin submits the "new user group" form. The group's name and initial members come from request; the caller is recorded as the creator. The parent row and the initial membership rows are written in a single transaction, so the group is never observable without its declared starting members. Raises if the requested name is already taken.

Access control

  • roboto_admin_only
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
name
required
string (Name)
members
Array of strings (Members)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "members": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_user_group

Look up a single user group by its ug_... id.

Triggered when an admin opens the detail view for a specific group, or when another service has a stored id and needs to resolve the current name and membership. Raises RobotoNotFoundException if no such group exists.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
user_group_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_user_group

Rename a user group and/or replace its full membership list.

Triggered when an admin saves edits in the user-group detail panel. request.members is a wholesale replacement of the membership set — to incrementally add or remove members without rewriting the whole list, use the dedicated /members endpoints below instead. The parent-row update and the membership rewrite happen inside one transaction so readers never see a half-applied change.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
user_group_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Name (string) or Name (null) (Name)
Array of Members (strings) or Members (null) (Members)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "members": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_user_group

Permanently delete a user group and its membership rows.

Triggered when an admin clicks "delete" on a group. Refuses (raising RobotoConflictException) if any feature flag still references this group — the operator must first detach the group from every flag that uses it, otherwise the flag's audience would silently lose its definition. Returns 204 No Content on success.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
user_group_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

add_user_group_members

Add user ids to an existing group's membership without disturbing current members.

Triggered when an admin uses the "add members" control on the group detail panel. request.members are inserted alongside the current membership; user ids that are already members are no-ops. Returns the updated record.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
user_group_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
members
required
Array of strings (Members)

Responses

Request samples

Content type
application/json
{
  • "members": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

remove_user_group_members

Remove user ids from a group's membership, leaving the group itself in place.

Triggered when an admin uses the "remove members" control on the group detail panel. User ids in request.members that are not currently members are no-ops; the group is preserved even if the call empties it. Returns the updated record.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
user_group_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
members
required
Array of strings (Members)

Responses

Request samples

Content type
application/json
{
  • "members": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_user_group_by_name

Look up a single user group by its unique display name.

Triggered when an operator (or the feature-flag admin flow) has a group name in hand — typically the value typed into a "associate user group with this flag" picker — and needs to resolve it to the current record before storing the association. Raises RobotoNotFoundException if no group with that name exists.

Access control

  • roboto_admin_only
Authorizations:
http
path Parameters
name
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

users

Create, read, and modify entities within Roboto's 'users' domain

get_current_user

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

create_user

Access control

  • roboto_admin_only
  • deny_actions
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
user_id
required
string (User Id)
Name (string) or Name (null) (Name)
Default: null
is_service_user
boolean (Is Service User)
Default: false
is_system_user
boolean (Is System User)
Default: false
Picture Url (string) or Picture Url (null) (Picture Url)
Default: null
Array of Default Notification Channels (strings) or Default Notification Channels (null) (Default Notification Channels)
Default: ["email"]
Array of Default Notification Types (strings) or Default Notification Types (null) (Default Notification Types)
Default: ["comment_mention"]

Responses

Request samples

Content type
application/json
{
  • "user_id": "string",
  • "name": null,
  • "is_service_user": false,
  • "is_system_user": false,
  • "picture_url": null,
  • "default_notification_channels": [
    ],
  • "default_notification_types": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_user

Access control

  • deny_actions
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
Name (string) or Name (null) (Name)
Default: null
Picture Url (string) or Picture Url (null) (Picture Url)
Default: null
Notification Channels Enabled (object) or Notification Channels Enabled (null) (Notification Channels Enabled)
Default: null
Notification Types Enabled (object) or Notification Types Enabled (null) (Notification Types Enabled)
Default: null

Responses

Request samples

Content type
application/json
{
  • "name": null,
  • "picture_url": null,
  • "notification_channels_enabled": null,
  • "notification_types_enabled": null
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

delete_user

Access control

  • deny_actions
Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

get_user_by_id

Authorizations:
http
path Parameters
user_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_invites_for_user

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

list_orgs

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

get_org_roles_for_user

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

whoami

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": { }
}

viz

Create, read, and modify entities within Roboto's 'viz' domain

create_workspace

Authorizations:
http
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
object (Config)

Responses

Request samples

Content type
application/json
{
  • "config": { }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_workspace

Authorizations:
http
path Parameters
workspace_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_workspace

Authorizations:
http
path Parameters
workspace_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
required
object (Config)

Responses

Request samples

Content type
application/json
{
  • "config": { }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

get_workspace_accessibility

Authorizations:
http
path Parameters
workspace_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

update_workspace_accessibility

Authorizations:
http
path Parameters
workspace_id
required
string
header Parameters
X-Roboto-Org-Id
string
X-Roboto-User-Id
string
Request Body schema: application/json
accessibility
required
string (WorkspaceAccessibilityLevel)
Enum: "public" "restricted"

The accessibility level of a single resource (workspace or dataset).

Responses

Request samples

Content type
application/json
{
  • "accessibility": "public"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}