Examples - Roe Documentation

SDK operations

Copy-ready calls for each operation available through this SDK. Required and optional inputs are shown inline in the code.

Agents

`agents_list`

List agents or create a new agent.

result, err := client.Agents.List(
    1,
    1,
)
if err != nil {
    log.Fatal(err)
}

`agents_create`

Create a new base agent.

result, err := client.Agents.Create(
    "name",
    "engineClassID",
    []map[string]any{{"key": "text", "data_type": "text/plain"}},
    map[string]any{"model": "gpt-5.5-2026-04-23"},
    "versionName",
    "description",
)
if err != nil {
    log.Fatal(err)
}

`agents_jobs_results_create`

Get results for multiple agent jobs

result, err := client.Agents.Jobs.RetrieveResultMany([]string{"job_id"})
if err != nil {
    log.Fatal(err)
}

`agents_jobs_statuses_create`

Get status for multiple agent jobs

result, err := client.Agents.Jobs.RetrieveStatusMany([]string{"job_id"})
if err != nil {
    log.Fatal(err)
}

`agents_jobs_artifacts_result_retrieve`

Get tool result artifact (result only)

result, err := client.Agents.Jobs.RetrieveArtifact(
    "jobID",
    "artifactKey",
)
if err != nil {
    log.Fatal(err)
}

`agents_jobs_references_retrieve`

Serve a reference file associated with an agent job.

content, err := client.Agents.Jobs.DownloadReference(
    "job_id",
    "resource_id",
    false,
)
if err != nil {
    log.Fatal(err)
}

`agents_jobs_result_retrieve`

Get agent job result data.

result, err := client.Agents.Jobs.RetrieveResult(
    "jobID",
)
if err != nil {
    log.Fatal(err)
}

`agents_jobs_cancel_create`

Cancel an agent job

err := client.Agents.Jobs.Cancel(
    "jobID",
)
if err != nil {
    log.Fatal(err)
}

`agents_jobs_delete_data_create`

Delete agent job data

result, err := client.Agents.Jobs.DeleteData(
    "jobID",
)
if err != nil {
    log.Fatal(err)
}

`agents_jobs_webhook_resend_create`

Resend agent job webhook

result, err := client.Agents.Jobs.ResendWebhook(
    "jobID",
    "webhookID",
)
if err != nil {
    log.Fatal(err)
}

`agents_jobs_status_retrieve`

Get agent job status.

result, err := client.Agents.Jobs.RetrieveStatus(
    "jobID",
)
if err != nil {
    log.Fatal(err)
}

`agents_run`

Run agent synchronously

result, err := client.Agents.RunSync(
    "agent_id",
    map[string]any{"text": "text"},
    map[string]any{},
    // optional: roe.RunOptions{SkipCache: true} bypasses the job-result cache
)
if err != nil {
    log.Fatal(err)
}

`agents_run_async_create`

Run agent asynchronously.

job, err := client.Agents.Run(
    "agent_id",
    300,
    map[string]any{"text": "text"},
    map[string]any{},
    // optional: roe.RunOptions{SkipCache: true} bypasses the job-result cache
)
if err != nil {
    log.Fatal(err)
}

`agents_run_async_many`

Run agent asynchronously with multiple inputs

batch, err := client.Agents.RunMany(
    "agent_id",
    []map[string]any{{"text": "text"}},
    300,
    map[string]any{},
    // optional: roe.RunOptions{SkipCache: true} bypasses the job-result cache
)
if err != nil {
    log.Fatal(err)
}

`agents_run_version`

Run agent version synchronously

result, err := client.Agents.RunVersionSync(
    "agent_id",
    "version_id",
    map[string]any{"text": "text"},
    map[string]any{},
    // optional: roe.RunOptions{SkipCache: true} bypasses the job-result cache
)
if err != nil {
    log.Fatal(err)
}

`agents_run_versions_async_create`

Run agent version asynchronously.

job, err := client.Agents.RunVersion(
    "agent_id",
    "version_id",
    300,
    map[string]any{"text": "text"},
    map[string]any{},
    // optional: roe.RunOptions{SkipCache: true} bypasses the job-result cache
)
if err != nil {
    log.Fatal(err)
}

`agents_destroy`

Delete a base agent.

err := client.Agents.Delete(
    "agentID",
)
if err != nil {
    log.Fatal(err)
}

`agents_retrieve`

Retrieve an agent.

result, err := client.Agents.Retrieve(
    "agentID",
)
if err != nil {
    log.Fatal(err)
}

`agents_partial_update`

Partially update an agent.

result, err := client.Agents.Update(
    "agentID",
    "name",
    &[]bool{true}[0],
    &[]bool{true}[0],
)
if err != nil {
    log.Fatal(err)
}

`agents_update`

Update a base agent.

result, err := client.Agents.Replace(
    "agentID",
    "name",
    &[]bool{true}[0],
    &[]bool{true}[0],
)
if err != nil {
    log.Fatal(err)
}

`agents_duplicate_create`

Duplicate an agent.

result, err := client.Agents.Duplicate("agent_id")
if err != nil {
    log.Fatal(err)
}

`agents_jobs_list`

List agent jobs or create a new agent job.

result, err := client.Agents.Jobs.ListJobs(
    "agentID",
    1,
    1,
    "statusCode",
    "versionName",
    "metadata",
    "createdFrom",
    "createdTo",
    "search",
    "ordering",
)
if err != nil {
    log.Fatal(err)
}

`agents_jobs_cancel_all_create`

Cancel all running agent jobs (:cancelAll)

result, err := client.Agents.Jobs.CancelAll(
    "agentID",
)
if err != nil {
    log.Fatal(err)
}

`agents_versions_list`

List agent versions.

params := &roe.ListVersionsParams{Page: 1, PageSize: 10}

result, err := client.Agents.Versions.ListPaginated(
    "agent_id",
    params,
)
if err != nil {
    log.Fatal(err)
}

`agents_versions_create`

Create a new agent version.

result, err := client.Agents.Versions.Create(
    "agentID",
    []map[string]any{{"key": "text", "data_type": "text/plain"}},
    map[string]any{"model": "gpt-5.5-2026-04-23"},
    "versionName",
    "description",
)
if err != nil {
    log.Fatal(err)
}

`agents_versions_current_retrieve`

Retrieve the current version of an agent.

getSupportsEval := true

result, err := client.Agents.Versions.RetrieveCurrentWithEval(
    "agent_id",
    &getSupportsEval,
)
if err != nil {
    log.Fatal(err)
}

`agents_versions_destroy`

Delete an agent version.

err := client.Agents.Versions.Delete(
    "agentID",
    "versionID",
)
if err != nil {
    log.Fatal(err)
}

`agents_versions_retrieve`

Retrieve an agent version.

result, err := client.Agents.Versions.Retrieve(
    "agentID",
    "versionID",
    &[]bool{true}[0],
)
if err != nil {
    log.Fatal(err)
}

`agents_versions_partial_update`

Partially update an agent version.

err := client.Agents.Versions.Update(
    "agentID",
    "versionID",
    "versionName",
    "description",
)
if err != nil {
    log.Fatal(err)
}

`agents_versions_update`

Update an agent version.

err := client.Agents.Versions.Replace(
    "agentID",
    "versionID",
    "versionName",
    "description",
)
if err != nil {
    log.Fatal(err)
}

Connections

`connections_list`

List/create connections.

result, err := client.Connections.List(
    "connectorType",
    "search",
    1,
    1,
)
if err != nil {
    log.Fatal(err)
}

`connections_create`

List/create connections.

result, err := client.Connections.Create(
    "connectorType",
    "name",
    map[string]any{},
    "description",
    map[string]any{},
    map[string]string{},
)
if err != nil {
    log.Fatal(err)
}

`connections_test_credentials_create`

Test credentials without storing them.

result, err := client.Connections.TestCredentials(
    "connectorType",
    map[string]any{},
    map[string]any{},
    map[string]string{},
)
if err != nil {
    log.Fatal(err)
}

`connections_destroy`

Manage connection.

err := client.Connections.Delete(
    "connectionID",
)
if err != nil {
    log.Fatal(err)
}

`connections_retrieve`

Manage connection.

result, err := client.Connections.Retrieve(
    "connectionID",
)
if err != nil {
    log.Fatal(err)
}

`connections_partial_update`

Manage connection.

result, err := client.Connections.Update(
    "connectionID",
    "name",
    "description",
    map[string]any{},
    map[string]any{},
    map[string]string{},
)
if err != nil {
    log.Fatal(err)
}

`connections_update`

Manage connection.

result, err := client.Connections.Replace(
    "connectionID",
    "name",
    "description",
    map[string]any{},
    map[string]any{},
    map[string]string{},
)
if err != nil {
    log.Fatal(err)
}

`connections_test_create`

Test connection.

result, err := client.Connections.Test(
    "connectionID",
)
if err != nil {
    log.Fatal(err)
}

Connectors

`connectors_retrieve`

List all connector types.

result, err := client.Connectors.List(
)
if err != nil {
    log.Fatal(err)
}

`connectors_retrieve_by_type`

Get connector details.

result, err := client.Connectors.Retrieve(
    "connectorType",
)
if err != nil {
    log.Fatal(err)
}

Discovery

`discovery_supported_models_list`

List supported model IDs

result, err := client.Discovery.ListSupportedModels(
    "capability",
)
if err != nil {
    log.Fatal(err)
}

`discovery_agent_engine_types_list`

List supported agent engine types

result, err := client.Discovery.ListAgentEngineTypes(
)
if err != nil {
    log.Fatal(err)
}

Policies

`policies_list`

List all policies and create a new policy.

result, err := client.Policies.List(
    1,
    1,
)
if err != nil {
    log.Fatal(err)
}

`policies_create`

List all policies and create a new policy.

result, err := client.Policies.Create(
    "name",
    map[string]any{},
    "description",
    "versionName",
)
if err != nil {
    log.Fatal(err)
}

`policies_destroy`

Retrieve, update, or delete a single policy by ID.

err := client.Policies.Delete(
    "policyID",
)
if err != nil {
    log.Fatal(err)
}

`policies_retrieve`

Retrieve, update, or delete a single policy by ID.

result, err := client.Policies.Retrieve(
    "policyID",
)
if err != nil {
    log.Fatal(err)
}

`policies_partial_update`

Retrieve, update, or delete a single policy by ID.

result, err := client.Policies.Update(
    "policyID",
    &[]string{"value"}[0],
    &[]string{"value"}[0],
)
if err != nil {
    log.Fatal(err)
}

`policies_update`

Retrieve, update, or delete a single policy by ID.

result, err := client.Policies.Replace(
    "policyID",
    "name",
    "description",
)
if err != nil {
    log.Fatal(err)
}

`policies_versions_list`

Create a new policy version or list all versions of a specific policy.

result, err := client.Policies.Versions.List("policy_id")
if err != nil {
    log.Fatal(err)
}

`policies_versions_create`

Create a new policy version or list all versions of a specific policy.

result, err := client.Policies.Versions.Create(
    "policy_id",
    map[string]any{},
    "version_name",
    "base_version_id",
)
if err != nil {
    log.Fatal(err)
}

`policies_versions_retrieve`

Get a specific policy version by policy_id and version_id.

result, err := client.Policies.Versions.Retrieve(
    "policy_id",
    "version_id",
)
if err != nil {
    log.Fatal(err)
}

Skill Sets

`skill_sets_list`

List the org’s skill sets and create a new one.

result, err := client.SkillSets.List(
    "ordering",
    1,
    1,
    "search",
)
if err != nil {
    log.Fatal(err)
}

`skill_sets_create`

List the org’s skill sets and create a new one.

result, err := client.SkillSets.Create(
    "name",
    "description",
)
if err != nil {
    log.Fatal(err)
}

`skill_sets_retrieve`

Retrieve, update, or delete a single skill set.

result, err := client.SkillSets.Retrieve(
    "id",
)
if err != nil {
    log.Fatal(err)
}

`skill_sets_partial_update`

Retrieve, update, or delete a single skill set.

result, err := client.SkillSets.Update(
    "id",
    "name",
    "description",
)
if err != nil {
    log.Fatal(err)
}

`skill_sets_destroy`

Retrieve, update, or delete a single skill set.

err := client.SkillSets.Delete(
    "id",
)
if err != nil {
    log.Fatal(err)
}

`skill_sets_versions_list`

List a skill set’s versions, or create a new version.

result, err := client.SkillSets.ListVersions(
    "skillSetId",
    1,
    1,
)
if err != nil {
    log.Fatal(err)
}

`skill_sets_versions_create`

List a skill set’s versions, or create a new version.

result, err := client.SkillSets.CreateVersion(
    "skillSetId",
    []map[string]any{{"relative_path": "SKILL.md", "content": "# Skill"}},
    "versionName",
    "baseVersionId",
    "summary",
    []map[string]any{{"path": "SKILL.md", "status": "edited", "note": "Updated labels"}},
)
if err != nil {
    log.Fatal(err)
}

`skill_sets_versions_retrieve`

Retrieve a version by its id, or by a set id (-> that set’s current version).

result, err := client.SkillSets.RetrieveVersion(
    "id",
)
if err != nil {
    log.Fatal(err)
}

`skill_sets_set_current_version`

Point a skill set at a specific version (set-current / rollback).

result, err := client.SkillSets.SetCurrentVersion(
    "skillSetId",
    "versionId",
)
if err != nil {
    log.Fatal(err)
}

`skill_sets_generate_version`

Author the next version of a skill set with an agent.

result, err := client.SkillSets.GenerateVersion(
    "skillSetId",
    "useCase",
    "baseVersionId",
    true,
    []string{"value"},
    []string{"value"},
    "policyId",
    "policyVersionId",
)
if err != nil {
    log.Fatal(err)
}

`skill_sets_generation_retrieve`

Returns the last generation and its status, or generation: null when no run exists.

result, err := client.SkillSets.GetGeneration(
    "skillSetId",
)
if err != nil {
    log.Fatal(err)
}

`skill_sets_generation_cancel`

Stop tracking a generation, cancelling it if it is still running

err := client.SkillSets.CancelGeneration(
    "skillSetId",
    "runId",
)
if err != nil {
    log.Fatal(err)
}

Tables

`tables_list`

List Roe tables

result, err := client.Tables.List(
)
if err != nil {
    log.Fatal(err)
}

`tables_query_create`

Run a read-only Roe table query

result, err := client.Tables.Query(
    "sql",
    1,
)
if err != nil {
    log.Fatal(err)
}

`tables_query_result_retrieve`

Get a Roe table query result

result, err := client.Tables.QueryResult(
    "tableQueryID",
)
if err != nil {
    log.Fatal(err)
}

`tables_destroy`

Delete a Roe table

err := client.Tables.Delete(
    "tableName",
)
if err != nil {
    log.Fatal(err)
}

`tables_describe_retrieve`

Describe a Roe table

result, err := client.Tables.Describe(
    "tableName",
)
if err != nil {
    log.Fatal(err)
}

`tables_preview_retrieve`

Preview a Roe table

result, err := client.Tables.Preview(
    "tableName",
    1,
)
if err != nil {
    log.Fatal(err)
}

`upload_table`

Upload a CSV as a Roe table

file := roe.FileUpload{Path: "file.csv"}

result, err := client.Tables.Upload(
    "table_name",
    file,
    true,
)
if err != nil {
    log.Fatal(err)
}

Users

`users_current_user_retrieve`

Get the current user

result, err := client.Users.Me()
if err != nil {
    log.Fatal(err)
}

Workflows

`workflows_list`

List workflows

result, err := client.Workflows.List(
    1,
    1,
    "search",
)
if err != nil {
    log.Fatal(err)
}

`workflows_create`

Create a workflow

result, err := client.Workflows.Create(
    "name",
    map[string]any{"inputs": []map[string]any{{"key": "customer_id"}}, "steps": []map[string]any{{"kind": "agent", "id": "check_risk", "base_agent_id": "agent_id", "agent_version_id": "version_id", "input_mapping": map[string]any{"customer": "{initial.customer_id}"}}}, "result": "check_risk"},
    "versionName",
    "description",
)
if err != nil {
    log.Fatal(err)
}

`workflows_retrieve`

Get a workflow

result, err := client.Workflows.Retrieve(
    "workflowId",
)
if err != nil {
    log.Fatal(err)
}

`workflows_partial_update`

Rename a workflow

result, err := client.Workflows.Update(
    "workflowId",
    "name",
)
if err != nil {
    log.Fatal(err)
}

`workflows_destroy`

Delete a workflow

err := client.Workflows.Delete(
    "workflowId",
)
if err != nil {
    log.Fatal(err)
}

`workflows_versions_list`

List workflow versions

result, err := client.Workflows.ListVersions(
    "workflowId",
    1,
    1,
)
if err != nil {
    log.Fatal(err)
}

`workflows_versions_create`

Save a workflow version

result, err := client.Workflows.CreateVersion(
    "workflowId",
    map[string]any{"inputs": []map[string]any{{"key": "customer_id"}}, "steps": []map[string]any{{"kind": "agent", "id": "check_risk", "base_agent_id": "agent_id", "agent_version_id": "version_id", "input_mapping": map[string]any{"customer": "{initial.customer_id}"}}}, "result": "check_risk"},
    "versionName",
    "description",
)
if err != nil {
    log.Fatal(err)
}

`workflows_versions_retrieve`

Get a workflow version

result, err := client.Workflows.RetrieveVersion(
    "workflowId",
    "versionId",
)
if err != nil {
    log.Fatal(err)
}

`workflows_versions_set_current_create`

Set the current workflow version

result, err := client.Workflows.SetCurrentVersion(
    "workflowId",
    "versionId",
)
if err != nil {
    log.Fatal(err)
}

`workflows_runs_list`

List workflow runs

result, err := client.Workflows.ListRuns(
    "workflowId",
    1,
    1,
    1,
)
if err != nil {
    log.Fatal(err)
}

`workflows_runs_create`

Run a workflow

result, err := client.Workflows.Run(
    "workflowId",
    map[string]any{"customer_id": "c_1"},
    "versionId",
    map[string]any{},
    true,
)
if err != nil {
    log.Fatal(err)
}

`workflows_runs_batch_create`

Run a workflow in batch

result, err := client.Workflows.RunBatch(
    "workflowId",
    []map[string]any{{"customer_id": "c_1"}},
    "versionId",
)
if err != nil {
    log.Fatal(err)
}

`workflows_runs_retrieve`

Get a workflow run

result, err := client.Workflows.RetrieveRun(
    "runId",
)
if err != nil {
    log.Fatal(err)
}

​SDK operations

​Agents

​agents_list

​agents_create

​agents_jobs_results_create

​agents_jobs_statuses_create

​agents_jobs_artifacts_result_retrieve

​agents_jobs_references_retrieve

​agents_jobs_result_retrieve

​agents_jobs_cancel_create

​agents_jobs_delete_data_create

​agents_jobs_webhook_resend_create

​agents_jobs_status_retrieve

​agents_run

​agents_run_async_create

​agents_run_async_many

​agents_run_version

​agents_run_versions_async_create

​agents_destroy

​agents_retrieve

​agents_partial_update

​agents_update

​agents_duplicate_create

​agents_jobs_list

​agents_jobs_cancel_all_create

​agents_versions_list

​agents_versions_create

​agents_versions_current_retrieve

​agents_versions_destroy

​agents_versions_retrieve

​agents_versions_partial_update

​agents_versions_update

​Connections

​connections_list

​connections_create

​connections_test_credentials_create

​connections_destroy

​connections_retrieve

​connections_partial_update

​connections_update

​connections_test_create

​Connectors

​connectors_retrieve

​connectors_retrieve_by_type

​Discovery

​discovery_supported_models_list

​discovery_agent_engine_types_list

​Policies

​policies_list

​policies_create

​policies_destroy

​policies_retrieve

​policies_partial_update

​policies_update

​policies_versions_list

​policies_versions_create

​policies_versions_retrieve

​Skill Sets

​skill_sets_list

​skill_sets_create

​skill_sets_retrieve

​skill_sets_partial_update

​skill_sets_destroy

​skill_sets_versions_list

​skill_sets_versions_create

​skill_sets_versions_retrieve

​skill_sets_set_current_version

​skill_sets_generate_version

​skill_sets_generation_retrieve

​skill_sets_generation_cancel

​Tables

​tables_list

​tables_query_create

​tables_query_result_retrieve

​tables_destroy

​tables_describe_retrieve

​tables_preview_retrieve

​upload_table

​Users

​users_current_user_retrieve

SDK operations

Agents

`agents_list`

`agents_create`

`agents_jobs_results_create`

`agents_jobs_statuses_create`

`agents_jobs_artifacts_result_retrieve`

`agents_jobs_references_retrieve`

`agents_jobs_result_retrieve`

`agents_jobs_cancel_create`

`agents_jobs_delete_data_create`

`agents_jobs_webhook_resend_create`

`agents_jobs_status_retrieve`

`agents_run`

`agents_run_async_create`

`agents_run_async_many`

`agents_run_version`

`agents_run_versions_async_create`

`agents_destroy`

`agents_retrieve`

`agents_partial_update`

`agents_update`

`agents_duplicate_create`

`agents_jobs_list`

`agents_jobs_cancel_all_create`

`agents_versions_list`

`agents_versions_create`

`agents_versions_current_retrieve`

`agents_versions_destroy`

`agents_versions_retrieve`

`agents_versions_partial_update`

`agents_versions_update`

Connections

`connections_list`

`connections_create`

`connections_test_credentials_create`

`connections_destroy`

`connections_retrieve`

`connections_partial_update`

`connections_update`

`connections_test_create`

Connectors

`connectors_retrieve`

`connectors_retrieve_by_type`

Discovery

`discovery_supported_models_list`

`discovery_agent_engine_types_list`

Policies

`policies_list`

`policies_create`

`policies_destroy`

`policies_retrieve`

`policies_partial_update`

`policies_update`

`policies_versions_list`

`policies_versions_create`

`policies_versions_retrieve`

Skill Sets

`skill_sets_list`

`skill_sets_create`

`skill_sets_retrieve`

`skill_sets_partial_update`

`skill_sets_destroy`

`skill_sets_versions_list`

`skill_sets_versions_create`

`skill_sets_versions_retrieve`

`skill_sets_set_current_version`

`skill_sets_generate_version`

`skill_sets_generation_retrieve`

`skill_sets_generation_cancel`

Tables

`tables_list`

`tables_query_create`

`tables_query_result_retrieve`

`tables_destroy`

`tables_describe_retrieve`

`tables_preview_retrieve`

`upload_table`

Users

`users_current_user_retrieve`