Endpoint Id Format: uuid
Optional
functions?: string[]Functions
Restricted
BatchStatusRequest
Task Ids
BatchStatusResponse
{
* "response": "batch",
* "results": {
* "7dac44aa-c480-4460-b453-a47b03b031f4": {
* "task_id": "7dac44aa-c480-4460-b453-a47b03b031f4",
* "status": "success",
* "result": "10000",
* "completion_t": "1677183605.212898"
* },
* "4b35645f-0c5b-465d-aaec-fee87f74ff5b": {
* "task_id": "4b35645f-0c5b-465d-aaec-fee87f74ff5b",
* "status": "failed",
* "reason": "Task failed"
* }
* }
* }
Response
Results
BatchStatusResponseResults
Optional
completion_t?: stringCompletion T
Optional
exception?: stringException
Optional
reason?: stringReason
Optional
result?: stringResult
Optional
status?: unknownStatus
Task Id Format: uuid
BatchSubmitResponseTask
Http Status Code
Optional
reason?: stringReason
Status
Task Uuid Format: uuid
BuildStatus
ConsoleNodeInfo
Optional
endpoint_version?: stringEndpoint Version
Optional
idle_duration_seconds?: numberIdle Duration Seconds
Optional
python_version?: stringPython Version
Optional
sdk_version?: stringSdk Version
Optional
total_worker_count?: numberTotal Worker Count
ConsoleResponse
{
* "user_endpoints": [
* {
* "user_endpoint_id": "7348422a-1074-427b-a08a-0771068afccc",
* "active": true,
* "python_version": "3.12.7",
* "endpoint_version": "3.1.1",
* "posix_pid": 12345,
* "posix_username": "test_user",
* "start_time_iso": "2025-01-02T21:20:19.123456-05:00",
* "start_time_unix": 1735870819.123456,
* "last_heartbeat_unix": 1735884207.498273,
* "running_task_count": 3,
* "queued_task_count": 0,
* "executed_task_count": 15,
* "total_worker_count": 2,
* "idle_worker_count": 0,
* "total_node_count": 1,
* "node_info": {
* "some_job_id": [
* {
* "total_worker_count": 2,
* "idle_duration_seconds": 0,
* "python_version": "3.12.7",
* "endpoint_version": "3.1.1",
* "sdk_version": "3.1.1"
* }
* ]
* },
* "engine_type": "GlobusComputeEngine",
* "provider_type": "SlurmProvider",
* "account": "my-slurm-account",
* "queue": "caslake",
* "config": "engine:\n type: GlobusComputeEngine\n max_workers_per_node: 2\n provider:\n type: SlurmProvider\n account: my-slurm-account\n partition: caslake\n worker_init: 'module load Anaconda; source activate compute-env'\n nodes_per_block: 1\n max_blocks: 1\n address:\n type: address_by_interface\n ifname: bond0\n"
* }
* ]
* }
User Endpoints
ConsoleUserEndpointInfo
Optional
account?: stringAccount
Active
Optional
client_sdk_versions?: string[]Client Sdk Versions
Optional
config?: stringConfig
Optional
endpoint_version?: stringEndpoint Version
Optional
engine_type?: stringEngine Type
User endpoint engine type. See our documentation for more information: https://globus-compute.readthedocs.io/en/latest/endpoints/config_reference.html#user-endpoint-configuration
Optional
executed_task_count?: numberExecuted Task Count
Optional
idle_worker_count?: numberIdle Worker Count
Optional
last_heartbeat_unix?: numberLast Heartbeat Unix
Optional
node_info?: {Node Info
Optional
posix_pid?: numberPosix Pid
Optional
posix_username?: stringPosix Username
Optional
provider_type?: stringProvider Type
User endpoint provider type. See our documentation for more information: https://globus-compute.readthedocs.io/en/latest/endpoints/config_reference.html#user-endpoint-configuration
Optional
python_version?: stringPython Version
Optional
queue?: stringQueue
Optional
queued_task_count?: numberQueued Task Count
Optional
running_task_count?: numberRunning Task Count
Optional
start_time_iso?: stringStart Time Iso Format: date-time
Optional
start_time_unix?: numberStart Time Unix
Optional
total_node_count?: numberTotal Node Count
Optional
total_worker_count?: numberTotal Worker Count
User Endpoint Id Format: uuid
ContainerBuildRequest
Apt
Conda
Optional
description?: stringDescription
Name
Optional
payload_url?: stringPayload Url Format: uri
Pip
ContainerBuildResponse
Container Id Format: uuid
ContainerBuildStatusResponse
ContainerRegisterRequest
Optional
description?: stringDescription
Location
Name
ContainerRegisterResponse
Container Id Format: uuid
ContainerRuntime
ContainerStatus
Optional
build_stderr?: stringBuild Stderr
Container Uuid Format: uuid
Optional
err_message?: stringErr Message
Optional
location?: stringLocation
Name
Optional
type?: "docker" | "singularity"ContainerStatusResponse
Optional
build_stderr?: stringBuild Stderr
Container Uuid Format: uuid
Optional
err_message?: stringErr Message
Optional
location?: stringLocation
Name
Optional
type?: "docker" | "singularity"DeleteFunctionResponse
Result
Endpoint
{
* "uuid": "7348422a-1074-427b-a08a-0771068afccc",
* "name": "My Endpoint",
* "display_name": "My Endpoint's display name",
* "multi_user": false,
* "high_assurance": false,
* "public": false,
* "endpoint_config": "",
* "user_config_template": {},
* "user_config_schema": {},
* "description": "My endpoint description",
* "hostname": "my-endpoint",
* "local_user": "user",
* "ip_address": "140.221.112.13",
* "endpoint_version": "1.0.10",
* "sdk_version": "1.0.10",
* "python_version": "3.12.7",
* "subscription_uuid": "b0b7b089-707a-4d90-a036-05b7964d6b60"
* }
Optional
config?: Record<string, unknown>Config
Optional
description?: stringDescription
Display Name
Optional
endpoint_config?: stringEndpoint Config
Optional
endpoint_version?: stringEndpoint Version
High Assurance
Optional
hostname?: stringHostname
Optional
ip_address?: stringIp Address Format: ipvanyaddress
Optional
local_user?: stringLocal User
Multi User
Name
Public
Optional
python_version?: stringPython Version
Optional
sdk_version?: stringSdk Version
Optional
subscription_uuid?: stringSubscription Uuid Format: uuid
Optional
user_config_schema?: Record<string, unknown>User Config Schema
Optional
user_config_template?: stringUser Config Template
Uuid Format: uuid
EndpointConfig
{
* "endpoint_id": "7348422a-1074-427b-a08a-0771068afccc",
* "task_queue_info": {
* "connection_url": "amqps://user:password@mq.fqdn",
* "exchange": "some_exchange",
* "queue": "some_queue"
* },
* "result_queue_info": {
* "connection_url": "amqps://user:password@mq.fqdn",
* "exchange": "some_exchange",
* "queue": "some_queue",
* "queue_publish_kwargs": {
* "exchange": "some_exchange",
* "routing_key": "some_key",
* "mandatory": true,
* "properties": {
* "delivery_mode": 2
* }
* }
* },
* "warnings": []
* }
Endpoint Id Format: uuid
Connection Url
Exchange
Queue
Exchange
Mandatory
Delivery Mode
Routing Key
Connection Url
Exchange
Queue
Optional
warnings?: string[]Warnings
EndpointConfigQueueInfo
Connection Url
Exchange
Queue
EndpointConfigResultQueue
Connection Url
Exchange
Queue
Exchange
Mandatory
Delivery Mode
Routing Key
EndpointConfigResultQueuePublish
Exchange
Mandatory
Delivery Mode
Routing Key
EndpointConfigResultQueuePublishProperties
Delivery Mode
EndpointDeleteResponse
Result
EndpointListResponseEntry
Display Name
Name
Owner Format: uuid
Uuid Format: uuid
EndpointMetadata
Optional
config?: Record<string, unknown>Config
Optional
description?: stringDescription
Optional
endpoint_config?: stringEndpoint Config
Optional
endpoint_version?: stringEndpoint Version
Optional
hostname?: stringHostname
Optional
ip_address?: stringIp Address Format: ipvanyaddress
Optional
local_user?: stringLocal User
Optional
python_version?: stringPython Version
Optional
sdk_version?: stringSdk Version
Optional
user_config_schema?: Record<string, unknown>User Config Schema
Optional
user_config_template?: stringUser Config Template
EndpointRegisterMetadata
Optional
config?: Record<string, unknown>Config
Optional
description?: stringDescription
Optional
endpoint_config?: stringEndpoint Config
Optional
endpoint_version?: stringEndpoint Version
Optional
hostname?: stringHostname
Optional
ip_address?: stringIp Address
Optional
local_user?: stringLocal User
Optional
python_version?: stringPython Version
Optional
sdk_version?: stringSdk Version
Optional
user_config_schema?: Record<string, unknown>User Config Schema
Optional
user_config_template?: stringUser Config Template
EndpointRegisterResponse
{
* "endpoint_id": "7348422a-1074-427b-a08a-0771068afccc",
* "task_queue_info": {
* "connection_url": "amqps://user:password@mq.fqdn",
* "exchange": "some_exchange",
* "queue": "some_queue"
* },
* "result_queue_info": {
* "connection_url": "amqps://user:password@mq.fqdn",
* "exchange": "some_exchange",
* "queue": "some_queue",
* "queue_publish_kwargs": {
* "exchange": "some_exchange",
* "routing_key": "some_key",
* "mandatory": true,
* "properties": {
* "delivery_mode": 2
* }
* }
* },
* "heartbeat_queue_info": {
* "connection_url": "amqps://user:password@mq.fqdn",
* "exchange": "some_exchange",
* "queue": "some_queue",
* "queue_publish_kwargs": {
* "exchange": "some_exchange",
* "routing_key": "some_key",
* "mandatory": true,
* "properties": {
* "delivery_mode": 2
* }
* }
* }
* }
Endpoint Id Format: uuid
Connection Url
Exchange
Queue
Exchange
Mandatory
Delivery Mode
Routing Key
Connection Url
Exchange
Queue
Exchange
Mandatory
Delivery Mode
Routing Key
Connection Url
Exchange
Queue
Optional
warnings?: string[]Warnings
EndpointStatusDetails
Idle Workers
Optional
managers?: numberManagers
Outstanding Tasks
Pending Tasks
Total Workers
EndpointStatusResponse
Optional
details?: {Idle Workers
Optional
managers?: numberManagers
Outstanding Tasks
Pending Tasks
Total Workers
Status
ErrorResponse
Code
Error Args
Http Status Code
Reason
Status
Function
Optional
description?: stringDescription
Function Code
Optional
function_name?: stringFunction Name
Function Uuid Format: uuid
Metadata
Optional
python_version?: stringPython Version
Optional
sdk_version?: stringSdk Version
FunctionMetadata
Optional
python_version?: stringPython Version
Optional
sdk_version?: stringSdk Version
EndpointLockResponse
Endpoint Id Format: uuid
Lock Expiration Timestamp Format: date-time
EndpointRegisterRequest
{
* "endpoint_name": "My Endpoint",
* "display_name": "My Endpoint's display name",
* "endpoint_uuid": "7348422a-1074-427b-a08a-0771068afccc",
* "version": "1.0.10",
* "multi_user": false,
* "allowed_functions": [
* "11291b86-4f9c-47cb-848e-d3c06285951c"
* ],
* "authentication_policy": "67b4e120-2638-4771-86bb-6ac2a0f69e0b",
* "metadata": {
* "endpoint_config": "",
* "user_config_template": {},
* "user_config_schema": {},
* "description": "My endpoint description",
* "ip_address": "140.221.112.13",
* "hostname": "my-endpoint",
* "local_user": "user",
* "sdk_version": "1.0.10",
* "endpoint_version": "1.0.10",
* "python_version": "3.12.7"
* }
* }
Optional
allowed_functions?: string[]Allowed Functions
Optional
authentication_policy?: stringAuthentication Policy Format: uuid
Endpoint users are evaluated against this Globus authentication policy. For more information on Globus authentication policies, visit https://docs.globus.org/api/auth/developer-guide/#authentication-policies.
Optional
display_name?: stringDisplay Name
Endpoint Name
Endpoint Uuid Format: uuid
Optional
metadata?: {Optional
config?: Record<string, unknown>Config
Optional
description?: stringDescription
Optional
endpoint_config?: stringEndpoint Config
Optional
endpoint_version?: stringEndpoint Version
Optional
hostname?: stringHostname
Optional
ip_address?: stringIp Address
Optional
local_user?: stringLocal User
Optional
python_version?: stringPython Version
Optional
sdk_version?: stringSdk Version
Optional
user_config_schema?: Record<string, unknown>User Config Schema
Optional
user_config_template?: stringUser Config Template
Multi User
Optional
version?: stringVersion
RegisterFunctionMetadata
Optional
python_version?: stringPython Version
Optional
sdk_version?: stringSdk Version
RegisterFunctionRequest
{
* "function_name": "My Function",
* "function_code": "wuX2RpbGyUjBBfY3JlYXRlX2Z1bmN0 ...",
* "description": "My first function",
* "metadata": {
* "python_version": "3.11.3",
* "sdk_version": "2.3.3"
* },
* "container_uuid": "b7a42fa2-e97f-4061-9e64-2ede22ae7f5e",
* "group": "a2d6feb6-5386-4a06-8a22-99ea5ad7e651",
* "public": false
* }
Optional
container_uuid?: stringContainer Uuid Format: uuid
Optional
description?: stringDescription
Optional
entry_point?: stringEntry Point
Function Code
Function Name
Optional
group?: stringGroup Format: uuid
Optional
metadata?: { python_version?: string; sdk_version?: string }Optional
python_version?: stringPython Version
Optional
sdk_version?: stringSdk Version
Public
BatchSubmitRequest
{
* "task_group_id": "97241626-8ff4-4550-9938-5909bd221869",
* "create_websocket_queue": false,
* "tasks": [
* [
* "116f1b48-0aab-4228-92f0-021c2ab14b5e",
* "ff960aba-fa23-43d5-9cbe-3f4f91a066e1",
* "... <serialized_arguments> ..."
* ],
* [
* "116f1b48-0aab-4228-92f0-021c2ab14b5e",
* "ff960aba-fa23-43d5-9cbe-3f4f91a066e1",
* "... <serialized_arguments> ..."
* ]
* ]
* }
Create Websocket Queue
Optional
task_group_id?: stringTask Group Id Format: uuid
Tasks
BatchSubmitResponse
{
* "response": "success",
* "task_group_id": "97241626-8ff4-4550-9938-5909bd221869",
* "results": [
* {
* "status": "success",
* "task_uuid": "7dac44aa-c480-4460-b453-a47b03b031f4",
* "http_status_code": 200
* },
* {
* "status": "success",
* "task_uuid": "4b35645f-0c5b-465d-aaec-fee87f74ff5b",
* "http_status_code": 200
* }
* ]
* }
Response
Results
Optional
task_group_id?: stringTask Group Id Format: uuid
EndpointLockResponse
Endpoint Id Format: uuid
Lock Expiration Timestamp
EndpointRegisterRequest
{
* "endpoint_name": "my_endpoint",
* "display_name": "My Endpoint's Display Name",
* "version": "2.2.0",
* "multi_user": false,
* "public": false,
* "high_assurance": false,
* "allowed_functions": [
* "11291b86-4f9c-47cb-848e-d3c06285951c"
* ],
* "authentication_policy": "67b4e120-2638-4771-86bb-6ac2a0f69e0b",
* "subscription_uuid": "59b63c41-a765-4971-ac9a-41742059ade3",
* "metadata": {
* "endpoint_config": "",
* "user_config_template": {},
* "user_config_schema": {},
* "description": "My endpoint description",
* "ip_address": "140.221.112.13",
* "hostname": "my-endpoint",
* "local_user": "user",
* "sdk_version": "2.2.0",
* "endpoint_version": "2.2.0",
* "python_version": "3.12.7"
* }
* }
Optional
admins?: string[]Admins
Optional
allowed_functions?: string[]Allowed Functions
Optional
authentication_policy?: stringAuthentication Policy Format: uuid
Endpoint users are evaluated against this Globus authentication policy. For more information on Globus authentication policies, visit https://docs.globus.org/api/auth/developer-guide/#authentication-policies.
Optional
display_name?: stringDisplay Name
Endpoint Name
High Assurance
Metadata
Optional
config?: Record<string, unknown>Config
Optional
description?: stringDescription
Optional
endpoint_config?: stringEndpoint Config
Optional
endpoint_version?: stringEndpoint Version
Optional
hostname?: stringHostname
Optional
ip_address?: stringIp Address Format: ipvanyaddress
Optional
local_user?: stringLocal User
Optional
python_version?: stringPython Version
Optional
sdk_version?: stringSdk Version
Optional
user_config_schema?: Record<string, unknown>User Config Schema
Optional
user_config_template?: stringUser Config Template
Multi User
Public
Optional
subscription_uuid?: stringSubscription Uuid Format: uuid
Optional
version?: stringVersion
RegisterFunctionMetadata
Python Version
Globus Compute SDK version
Serde Identifier
Identifier of SDK method used to serialize the function; the identifiers are not currently specifically documented, but may be found in the Globus Compute SDK repository as the identifier
class variable of the respective serializers
RegisterFunctionRequest
{
* "function_name": "dot_product",
* "function_code": "850\n01\ngASVZwIAAAAAAACMCmRpbGwuX2RpbGyUjBB...",
* "description": "Dot product of two vectors (unchecked length)",
* "metadata": {
* "python_version": "3.13.3",
* "sdk_version": "3.1.1",
* "serde_identifier": "01"
* },
* "public": true
* }
Optional
description?: stringDescription
Function Code
Function Name
Optional
group?: stringGroup Format: uuid
If specified, this function will be accessible to members of the Globus Group specified by this identifier
Optional
ha_endpoint_id?: stringHa Endpoint Id Format: uuid
Meta
Python Version
Globus Compute SDK version
Serde Identifier
Identifier of SDK method used to serialize the function; the identifiers are not currently specifically documented, but may be found in the Globus Compute SDK repository as the identifier
class variable of the respective serializers
Public
BatchSubmitRequest
{
* "task_group_id": "97241626-8ff4-4550-9938-5909bd221869",
* "user_endpoint_config": {
* "min_blocks": 0,
* "max_blocks": 1,
* "scheduler_options": "#SBATCH --constraint=knl,quad,cache"
* },
* "resource_specification": {
* "num_nodes": 2,
* "ranks_per_node": 2,
* "num_ranks": 4,
* "launcher_options": "--cpu-bind quiet --mem 3072"
* },
* "result_serializers": [
* "globus_compute_sdk.serialize.JSONData",
* "globus_compute_sdk.serialize.DillDataBase64"
* ],
* "create_queue": true,
* "tasks": {
* "ff960aba-fa23-43d5-9cbe-3f4f91a066e1": [
* "... <serialized_arguments> ...",
* "... <serialized_arguments> ...",
* "..."
* ],
* "0a98fd06-edbd-11ed-abcd-0d705ebb4c49": [
* "... <serialized_arguments> ...",
* "..."
* ]
* }
* }
Create Queue
If true
, create a Task Group specific AMQP queue for the results. In addition to the usual longer-term storage, results will also be copied to this AMQP queue, enabling consumers to get event-driven (instant) results. (See the Globus Compute SDK Executor for an implementation that uses this feature.)
Optional
resource_specification?: {Resource Specification
Optional
launcher_options?: stringLauncher Options
Num Nodes
Optional
num_ranks?: numberNum Ranks
Optional
ranks_per_node?: numberRanks Per Node
Optional
result_serializers?: string[]Result Serializers
A list of import paths to SerializationStrategy subclasses that the endpoint is allowed to use when serializing results.
Optional
task_group_id?: stringTask Group Id Format: uuid
Tasks
Optional
user_endpoint_config?: Record<string, unknown>User Endpoint Config
Optional
user_runtime?: {User Runtime
Optional
globus_compute_sdk_version?: stringGlobus Compute Sdk Version
Optional
globus_sdk_version?: stringGlobus Sdk Version
Optional
python_version?: stringPython Version
BatchSubmitResponse
{
* "request_id": "5158de19-10b5-4deb-9d87-a86c1dec3460",
* "task_group_id": "97241626-8ff4-4550-9938-5909bd221869",
* "endpoint_id": "116f1b48-0aab-4228-92f0-021c2ab14b5e",
* "tasks": {
* "ff960aba-fa23-43d5-9cbe-3f4f91a066e1": [
* "89bde6c3-85e9-4834-b0e8-5cb51955eaf5",
* "1e900b37-7a80-424b-aeac-56dd2860f59a",
* "9f12a732-3aa6-4878-9d58-b290837ab096"
* ],
* "0a98fd06-edbd-11ed-abcd-0d705ebb4c49": [
* "022151bf-7b2d-4240-b4d0-9ac5b7077314",
* "1f6f5f1e-15b0-4916-85ff-471511bd35d6"
* ]
* }
* }
Endpoint Id Format: uuid
Request Id
Task Group Id Format: uuid
Tasks
FuncxStatsResponse
Total Function Invocations
FuncxVersionResponse
Api
Optional
container_service?: stringContainer Service
Optional
git_sha?: stringGit Sha
Optional
min_ep_version?: stringMin Ep Version
Optional
min_sdk_version?: stringMin Sdk Version
HTTPValidationError
Optional
detail?: { loc: (string | number)[]; msg: string; type: string }[]Detail
MultiUserEndpointConfig
Connection Url
Exchange
Queue
Endpoint Id Format: uuid
Optional
warnings?: string[]Warnings
MultiUserEndpointRegisterResponse
{
* "endpoint_id": "7348422a-1074-427b-a08a-0771068afccc",
* "command_queue_info": {
* "connection_url": "amqps://user:password@mq.fqdn",
* "exchange": "some_exchange",
* "queue": "some_queue"
* },
* "result_queue_info": {
* "connection_url": "amqps://user:password@mq.fqdn",
* "exchange": "some_exchange",
* "queue": "some_queue",
* "queue_publish_kwargs": {
* "exchange": "some_exchange",
* "routing_key": "some_key",
* "mandatory": true,
* "properties": {
* "delivery_mode": 2
* }
* }
* },
* "heartbeat_queue_info": {
* "connection_url": "amqps://user:password@mq.fqdn",
* "exchange": "some_exchange",
* "queue": "some_queue",
* "queue_publish_kwargs": {
* "exchange": "some_exchange",
* "routing_key": "some_key",
* "mandatory": true,
* "properties": {
* "delivery_mode": 2
* }
* }
* }
* }
Connection Url
Exchange
Queue
Endpoint Id Format: uuid
Connection Url
Exchange
Queue
Exchange
Mandatory
Delivery Mode
Routing Key
Connection Url
Exchange
Queue
Exchange
Mandatory
Delivery Mode
Routing Key
Optional
warnings?: string[]Warnings
ReadQueueInfo
Connection Url
Exchange
Queue
RegisterFunctionResponse
Function Uuid Format: uuid
ResourceSpecification
Optional
launcher_options?: stringLauncher Options
Num Nodes
Optional
num_ranks?: numberNum Ranks
Optional
ranks_per_node?: numberRanks Per Node
ResultAmqpUrlResponse
Connection Url Format: uri
Queue Prefix
TaskGroupResponse
Optional
create_websockets_queue?: booleanCreate Websockets Queue
Taskgroup Id Format: uuid
Tasks
TaskGroupResponseTask
Created At Format: date-time
Id Format: uuid
TaskStatusResponse
{
* "task_id": "7dac44aa-c480-4460-b453-a47b03b031f4",
* "status": "success",
* "result": "10000",
* "completion_t": "1677183605.212898",
* "details": {
* "os": "Linux-5.19.0-1025-aws-x86_64-with-glibc2.35",
* "python_version": "3.10.4",
* "dill_version": "0.3.5.1",
* "globus_compute_sdk_version": "2.3.2",
* "task_transitions": {
* "execution-start": 1692742841.843334,
* "execution-end": 1692742846.123456
* }
* }
* }
Optional
completion_t?: stringCompletion T
Optional
details?: Record<string, unknown>Details
Optional
exception?: stringException
Optional
result?: stringResult
Optional
status?: unknownStatus
Task Id Format: uuid
UserRuntime
Optional
globus_compute_sdk_version?: stringGlobus Compute Sdk Version
Optional
globus_sdk_version?: stringGlobus Sdk Version
Optional
python_version?: stringPython Version
ValidationError
Location
Message
Error Type
ValidationErrorResponse
Code
Error Args
Http Status Code
Reason
Status
VersionService
WriteQueueInfo
Connection Url
Exchange
Queue
Exchange
Mandatory
Delivery Mode
Routing Key
WriteQueuePublishKwargs
Exchange
Mandatory
Delivery Mode
Routing Key
WriteQueuePublishProperties
Delivery Mode
AllowedFunctionsResponse